访问swagger-ui.html404

如果您遇到了访问Swagger UI页面时出现404错误的情况，可能是由于以下原因导致的： 1. 您的应用程序并没有正确地配置Swagger UI。请确保您的应用程序正确地配置了Swagger UI，并将其绑定到了正确的端口。 2. 您的应用程序可能没有正确地指向Swagger UI的路径。请确保您的应用程序正确地指向了Swagger UI的路径，并且该路径是有效的。 3. 您的应用程序可能没有启用Swagger UI。请确保您的应用程序已经启用了Swagger UI，并且已经正确地配置了相关的选项。 4. 您的网络环境可能存在问题。请检查您的网络环境，并确保您可以正常地访问Swagger UI所在的服务器。 如果您仍然无法解决这个问题，请尝试联系您的开发人员或者服务器管理员，以获取更进一步的帮助。

### 解决 Satoken 集成 Swagger-UI 页面访问出现 404 的方案 当遇到 Sa-Token 和 Spring Cloud Gateway 或其他网关组件集成时，Swagger-UI 页面无法正常加载并返回 404 错误的情况，通常是因为路径匹配或资源拦截设置不当所致[^1]。 为了确保 Swagger-UI 能够正确显示，在配置 Sa-Token 过滤器时需要注意排除静态资源请求。具体做法如下： #### 修改 `sa-token` 排除规则 在项目中的安全配置类里调整忽略 URL 设置，使 `/swagger-ui.html` 及其关联的静态文件免受认证机制的影响： ```java import cn.dev33.satoken.config.SaTokenConfig; import org.springframework.context.annotation.Bean; @Bean public SaTokenConfig getSaTokenConfig() { return new SaTokenConfig() .setExcludeUrl("/swagger-resources/**,/v2/api-docs,/webjars/**,/swagger-ui.html"); } ``` #### 处理跨域问题 如果应用部署于不同域名之下，则还需考虑 CORS (Cross-Origin Resource Sharing) 政策带来的影响。可以通过自定义全局过滤器来允许特定源站访问 API 文档接口[^2]: ```java import org.springframework.cloud.gateway.filter.GatewayFilterChain; import org.springframework.web.server.ServerWebExchange; import reactor.core.publisher.Mono; @Component public class CorsGlobalFilter implements GlobalFilter { @Override public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) { HttpHeaders headers = exchange.getRequest().getHeaders(); // 添加CORS响应头 exchange.getResponse().getHeaders().add("Access-Control-Allow-Origin", "*"); exchange.getResponse().getHeaders().add("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS"); exchange.getResponse().getHeaders().add("Access-Control-Max-Age", "3600"); exchange.getResponse().getHeaders().add("Access-Control-Allow-Headers", "authorization, content-type"); if ("OPTIONS".equalsIgnoreCase(headers.getFirst("Access-Control-Request-Method"))) { return exchange.getResponse().setComplete(); } return chain.filter(exchange); } } ``` 通过上述措施应该能够有效解决由于引入 Sa-Token 后导致的 Swagger UI 访问异常情况。当然实际开发过程中还需要根据具体的业务场景灵活调整相关参数配置。