### 解决方案
Spring Boot 整合 Swagger 2.9.2 后无法正常访问的
问题通常由多种原因引起，以下是详细的分析和解决方案。
#### 1
. **路径匹配机制冲突**
从提供的资料来看，
问题的核心在于
Spring Boot 2.6
.x
版本引入了 `PathPatternParser` 路径匹配器作为默认实现，而
Swagger 基于的是传统的 `AntPathMatcher`[^3]。这种差异可能导致某些路径解析失败，从而引发 4
04 错误。
##### 修改配置以兼容旧版路径匹配逻辑
可以通过调整
Spring Boot 的路径匹配策略来解决此
问题：
```java
import org
.springframework
.context
.annotation
.Configuration;
import org
.springframework
.web
.servlet
.config
.annotation
.PathMatchConfigurer;
import org
.springframework
.web
.servlet
.config
.annotation
.WebMvcConfigurer;
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void configurePathMatch(PathMatchConfigurer configurer) {
// 设置为 AntPathMatcher，默认是 PathPatternParser
configurer
.setUseRegisteredSuffixPatternMatch(true);
configurer
.setUseTrailingSlashMatch(true)
.setPathMatcher(new org
.springframework
.util
.AntPathMatcher());
}
}
```
通过上述代码片段，可以强制
Spring Boot 使用 `AntPathMatcher` 来处理请求路径匹配，从而避免与
Swagger 的路径定义发生冲突。
---
####
2. **依赖
版本一致性**
确保 Maven 或 Gradle 中的依赖项正确无误，并且各组件之间的
版本相互兼容。以下是一个典型的
Spring Boot 和
Swagger 集成所需的依赖列表：
```xml
<dependency>
<groupId>io
.springfox</groupId>
<artifactId>
springfox-
swagger2</artifactId>
<version>
2.9.2</version>
</dependency>
<dependency>
<groupId>io
.springfox</groupId>
<artifactId>
springfox-
swagger-ui</artifactId>
<version>
2.9.2</version>
</dependency>
```
如果使用其他工具链（如 OpenAPI），则需额外验证其是否支持当前使用的
Spring Boot 版本[^1]。
---
#### 3
. **启用
Swagger功能**
确认已正确启用了
Swagger 功能，在主类或者配置文件中添加如下注解：
```java
import
springfox
.documentation
.swagger2.annotations
.Enable
Swagger2;
@
SpringBootApplication
@Enable
Swagger2
public class Application {
public static void main(String[] args) {
SpringApplication
.run(Application
.class, args);
}
}
```
同时还需要创建一个 Bean 定义 Docket 对象以便自定义 API 文档的行为：
```java
import
springfox
.documentation
.builders
.ApiInfoBuilder;
import
springfox
.documentation
.service
.ApiInfo;
import
springfox
.documentation
.spi
.DocumentationType;
import
springfox
.documentation
.spring.web
.plugins
.Docket;
@Configuration
public class
SwaggerConfiguration {
@Bean
public Docket api() {
return new Docket(DocumentationType
.SWAGGER_
2)
.apiInfo(apiInfo())
.select()
.build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("My RESTful APIs")
.description("")
.version("1
.0")
.build();
}
}
```
以上设置能够帮助开发者更灵活地控制哪些接口会被纳入到文档生成范围之内[^
2]。
---
#### 4
. **检查静态资源映射规则**
有时即使完成了上述操作仍然会遇到页面加载失败的情况，这可能是因为前端 UI 文件未被正确暴露给外部客户端访问所致。此时可以在应用
启动时打印日志查看实际部署位置并手动指定资源目录地址：
```properties
spring.resources
.static-locations=classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/
```
将该属性加入 application
.properties 或者 yaml 格式的配置文件即可解决
问题。
---
### 总结
综上所述，针对
Spring Boot 整合 Swagger 2.9.2 后无法正常访问的现象可以从以下几个方面入手排查：一是修改全局路径匹配算法；二是核对第三方库间的协作关系；三是开启必要的扫描开关；四是重新规划公共资源定位方式。每一步都至关重要，缺一不可。
扫一扫
1859
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
