<think>好的，我现在遇到了
访问swagger-ui.html页面返回
404的
问题，需要解决。首先，我得回想一下可能的常见原因。根据之前学过的知识，
Swagger的依赖是否正确可能是关键。比如，用户可能还在使用旧的
Swagger2依赖，而升级到
Swagger3之后，配置方式和路径可能发生了变化。
首先，检查依赖是否正确。根据引用[1]，
Swagger3.0需要替换依赖为
springfox
-boot-starter，并且
版本要
3.0.0以上。如果用户还在使用旧
版本的依赖，比如
springfox
-swagger2，那么可能会导致路径不正确，从而出现
404错误。所以第一步是确认pom
.xml或者b
uild
.gradle中的依赖是否正确。用户需要将依赖替换成正确的starter，如：
```xml
<dependency>
<groupId>io
.springfox</groupId>
<artifactId>
springfox
-boot-starter</artifactId>
<version>
3.0.0</version>
</dependency>
```
接下来，检查配置类是否正确。在
Swagger3.0之后，不再需要@Enable
Swagger2注解，这一点在引用[1]中提到过。所以如果用户还在使用这个注解，应该删除它。同时，需要确保Docket的配置是否正确，比如使用DocumentationType
.SWAGGER_
2，并且配置了正确的API扫描路径。配置类的代码示例可以参考引用[1]中的代码，确保basePackage正确指向了需要生成文档的控制器所在的包。
然后，需要检查资源路径是否被正确配置。有时候，
Spring Security或者其他的拦截器可能会拦截
Swagger的静态资源，导致无法
访问。根据引用[
3]，可以通过实现WebMvcConfigurer接口，添加资源处理器来解决这个
问题。例如，在配置类中添加：
```java
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry
.addResourceHandler("
swagger-ui.html")
.addResourceLocations("classpath:/META
-INF/resources/");
registry
.addResourceHandler("/webjars/**")
.addResourceLocations("classpath:/META
-INF/resources/webjars/");
}
```
这样可以确保
Swagger的静态资源能够被正确加载。另外，如果项目使用了
Spring Security，还需要在安全配置中允许对
Swagger相关路径的
访问，比如：
```java
.antMatchers("/
swagger-ui.html", "/v
3/api
-docs/**", "/
swagger-resources/**", "/webjars/**")
.permitAll()
```
否则，这些路径可能会被拦截，导致
404或者4
03错误。
另外，根据引用[4]，如果以上方法都不奏效，可能需要尝试替换依赖，比如使用knife4j的starter来替代原生的
Swagger依赖。Knife4j是一个
Swagger的增强工具，可能在某些情况下兼容性更好。例如，引入：
```xml
<dependency>
<groupId>com
.github
.xiaoymin</groupId>
<artifactId>knife4j
-openapi
3-jakarta
-spring-boot-starter</artifactId>
<version>4
.1
.0</version>
</dependency>
```
然后
访问对应的路径，比如/doc
.html，而不是原来的
swagger-ui.html。这可以作为备选方案。
此外，还需要确认
访问的URL是否正确。在
Swagger3中，默认的
访问路径可能发生了变化，比如有些
版本需要
访问/
swagger-ui/index
.html而不是/
swagger-ui.html。这时候可能需要尝试不同的路径，或者查看文档确认正确的URL。
最后，如果所有配置都正确，但仍然出现
404，可能需要检查项目的类路径，确认META
-INF/resources目录下是否存在
swagger-ui.html文件。有时候，依赖没有正确下载或者打包时被排除，导致资源文件缺失。可以清理Maven或Gradle的缓存，重新构建项目，确保所有依赖正确引入。
总结起来，解决步骤应该是：
1
. 检查并更新依赖到正确的
版本。
2. 配置
Swagger的Docket类，移除旧注解。
3. 添加资源处理器，允许
访问静态资源。
4
. 调整安全配置，允许相关路径。
5
. 尝试替换依赖或
访问不同的URL路径。
6
. 确认项目构建正确，资源文件存在。
如果用户按照这些步骤逐一排查，应该能够解决
swagger-ui.html 404的
问题。</think>###
Swagger-ui.html 访问返回
404 解决方案
#### 1
. **检查依赖配置**
- **
Swagger3.0+依赖需使用官方推荐格式**
确保`pom
.xml`中替换为以下依赖（旧
版本依赖可能导致路径冲突）：
```xml
<dependency>
<groupId>io
.springfox</groupId>
<artifactId>
springfox
-boot-starter</artifactId>
<version>
3.0.0</version>
</dependency>
```
若仍无效，可尝试使用`knife4j`增强依赖（引用[4]）：
```xml
<dependency>
<groupId>com
.github
.xiaoymin</groupId>
<artifactId>knife4j
-openapi
3-jakarta
-spring-boot-starter</artifactId>
<version>4
.1
.0</version>
</dependency>
```
####
2. **修正
Swagger配置类**
- **移除旧注解**：
Swagger3.0+已删除`@Enable
Swagger2`，无需使用（引用[1]）。
- **配置Docket与API信息**：
```java
@Configuration
public class
SwaggerConfig {
@Bean
public Docket docket() {
return new Docket(DocumentationType
.SWAGGER_
2)
.apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors
.basePackage("com
.example
.controller")) // 替换为实际包路径
.paths(PathSelectors
.any())
.b
uild();
}
private ApiInfo apiInfo() {
return new ApiInfoB
uilder()
.title("API文档")
.description("接口说明")
.version("1
.0")
.b
uild();
}
}
```
####
3. **添加静态资源映射**
- **解决资源拦截
问题**（引用[
3]）
实现`WebMvcConfigurer`，添加资源处理器：
```java
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry
.addResourceHandler("
swagger-ui.html")
.addResourceLocations("classpath:/META
-INF/resources/");
registry
.addResourceHandler("/webjars/**")
.addResourceLocations("classpath:/META
-INF/resources/webjars/");
}
```
#### 4
. **调整
访问路径**
- **尝试不同URL**
Swagger3.0默认路径可能为`/
swagger-ui/index
.html`，而非`/
swagger-ui.html`。若返回
404，可尝试以下路径：
```bash
http://localhost:8
08
0/
swagger-ui/index
.html
```
若使用`knife4j`，
访问路径为`/doc
.html`。
#### 5
. **检查安全配置**
- **允许
Swagger相关路径**
若项目集成
Spring Security，需在安全配置中放行：
```java
@Override
protected void configure(HttpSecurity http) throws Exception {
http
.authorizeRequests()
.antMatchers("/
swagger-ui.html", "/v
3/api
-docs/**", "/
swagger-resources/**", "/webjars/**")
.permitAll()
.anyRequest()
.authenticated();
}
```
#### 6
. **验证依赖完整性**
- **确认资源文件存在**
检查`target/classes/META
-INF/resources`目录下是否有`
swagger-ui.html`。若无，清理Maven/Gradle缓存并重新构建项目。
---
###
本文探讨了深度学习技术如何革新图像色彩空间处理和视频编解码，以及在美颜直播特效中的实际应用，展示了前沿的OpenCV和深度学习模型的应用实例。
扫一扫
2958
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
