<think>嗯，用户遇到了
Swagger UI
访问404的问题，需要解决。首先，我得回忆一下常见的
Swagger配置错误。根据用户提供的引用内容，可能的原因有几个：跨域配置冲突、路径错误、静态资源处理问题。
用户提到他们之前集成了Shiro并处理了跨域，然后通过继承WebMvcConfigurationSupport导致
Swagger无法
访问。这说明可能因为自定义的WebMvc配置覆盖了默认设置，使得
Swagger的静态资源路径没有被正确加载。这时候需要检查是否在自定义配置类中添加了资源处理器，把
Swagger相关的静态路径排除
或者覆盖了。
另外，引用的资料提到正确的
访问路径应该是包含项目名和/
swagger-ui/index.html，而不是传统的/
swagger-ui.html。这可能是因为
Swagger版本升级后路径发生了变化，用户可能还在用旧路径
访问，导致404。需要确认用户使用的
Swagger版本，并指导他们使用正确的URL。
还有静态资源的问题，引用指出
Swagger的
页面是jar包内的，不需要修改静态资源路径，但若
Spring Boot的静态资源处理被自定义配置干扰，可能会导致无法正确加载这些资源。例如，继承WebMvcConfigurationSupport会禁用自动配置，需要手动添加资源路径。
接下来，解决方案应该分步骤：检查依赖配置，确保
Swagger相关依赖正确；检查MVC配置，添加资源处理；检查
访问路径是否正确；处理Shiro等安全框架的拦截，放行
Swagger相关路径。同时，可能需要检查应用上下文路径是否配置，影响最终
访问URL。
用户可能需要一步步检查这些方面，比如查看是否添加了@Enable
Swagger2注解，
SwaggerConfig是否正确配置，资源处理器是否添加了
swagger相关的路径，以及安全框架的配置是否有排除
Swagger的路径。此外，确认
访问的URL是否符合新版本的格式，比如是否有/index.html后缀。
最后，测试时可能需要重启应用，清除浏览器缓存，
或者尝试不同的
访问路径。如果所有配置都正确，但问题依旧，可能需要进一步检查是否有其他拦截器或过滤器阻止了请求。</think>###
Swagger UI
访问404错误的解决方案
#### 一、问题原因分析
1. **路径错误**：新版本
Swagger的
访问路径已调整为`/
swagger-ui/index.html`，而非传统的`/
swagger-ui.html`[^
2]。
2. **静态资源拦截**：若自定义了`WebMvcConfigurationSupport`，会覆盖默认静态资源配置，导致
Swagger资源路径失效[^1][^3]。
3. **安全框架冲突**：Shiro等安全框架未放行
Swagger相关路径，导致请求被拦截[^1]。
4. **依赖缺失**：未正确引入`
springfox-boot-starter`或版本不兼容。
#### 二、逐步解决方案
##### 1. 检查依赖配置
确保`pom.xml`包含以下依赖（
Spring Boot
2.6+需注意版本兼容性）：
```xml
<dependency>
<groupId>io.
springfox</groupId>
<artifactId>
springfox-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
```
#####
2. 修复MVC配置
若已继承`WebMvcConfigurationSupport`，需手动添加
Swagger资源路径：
```
java
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/
swagger-ui/**")
.addResourceLocations("classpath:/META-INF/resources/webjars/
springfox-
swagger-ui/");
}
```
##### 3. 调整
访问路径
使用以下格式
访问（假设项目上下文路径为`/api`）：
$$ \text{http://localhost:8080/api/
swagger-ui/index.html} $$
##### 4. 安全框架配置
在Shiro过滤器中放行
Swagger路径：
```
java
filterChainDefinitionMap.put("/
swagger-ui/**", "anon");
filterChainDefinitionMap.put("/v3/api-docs/**", "anon");
```
##### 5. 验证配置类
确保存在
Swagger配置类：
```
java
@Configuration
@Enable
Swagger2
public class
SwaggerConfig {
@Bean
public Docket api() {
return new Docket(DocumentType.
SWAGGER_
2)
.select()
.apis(RequestHandlerSelectors.any())
.paths(PathSelectors.any())
.build();
}
}
```
#### 三、补充说明
| 现象 | 解决方案 | 相关引用 |
|------------|-----------------------------------|----------|
| 白屏无内容 | 检查资源处理器是否添加 | |
| 401未授权 | 在安全框架中放行`/v3/api-docs`路径| |
|
页面加载不全| 检查浏览器控制台
报错，通常为CSS/JS路径问题 | |
扫一扫
1887
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
