springboot3整合swagger 404
时间: 2025-01-25 21:56:28 浏览: 64
### Spring Boot 3 中集成 Swagger 出现 404 的解决方案
在 Spring Boot 3 中配置 Swagger 可能会遇到访问 `swagger-ui.html` 页面返回 404 错误的情况。这通常是因为依赖项或配置不正确所致。
#### 1. 添加正确的依赖项
为了使 Swagger 正常工作,需要确保项目中包含了合适的依赖库。对于 Spring Boot 3 版本而言,推荐使用 `springdoc-openapi-starter-webmvc-ui` 替代旧版本中的 `springfox-swagger2` 和 `springfox-swagger-ui`[^2]:
```xml
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
<version>2.0.2</version><!-- 确认此版本兼容Spring Boot 3 -->
</dependency>
```
#### 2. 修改 application.properties 文件
确认应用程序属性文件内已设置允许暴露端点信息:
```properties
management.endpoints.web.exposure.include=*
management.endpoint.health.show-details=always
```
#### 3. 访问路径调整
默认情况下,在引入上述依赖之后,应该能够通过 `/swagger-ui/index.html` 或者更简单的 `/swagger-ui.html` 来访问文档界面而不是之前的 `/swagger-ui.html` 路径[^4]。
如果仍然无法正常显示页面,则可能还需要进一步排查其他潜在原因,比如安全配置拦截了请求或是资源映射存在问题等。
阅读全文
相关推荐


















