springdoc.swagger-ui.path配置不生成对应端点问题求助

云上老周

2026-6-13

解决方案

先验证默认路径是否可用
暂时注释掉springdoc.swagger-ui.path=/swagger-ui配置，直接访问http://localhost:8080/swagger-ui.html。如果能正常打开，说明自定义路径配置存在问题，再核对2.8.8版本的官方文档确认属性名（虽然你说已经查过，但再确认下是否是springdoc.swagger-ui.path而非其他类似属性），尝试将配置改为springdoc.swagger-ui.path=/swagger-ui后，访问http://localhost:8080/swagger-ui/index.html试试——部分新版本中自定义路径需要加上/index.html后缀。
排查静态资源拦截
如果项目中有自定义的WebMvcConfigurer或者拦截器，检查是否误拦截了Swagger相关的静态资源路径。需要确保放行以下路径：
```
@Override
public void addInterceptors(InterceptorRegistry registry) {
    registry.addInterceptor(yourCustomInterceptor)
            .excludePathPatterns("/swagger-ui/**", "/v3/api-docs/**", "/v3/api-docs.yaml");
}
```
另外，如果有配置ResourceHandler，也要确保没有覆盖掉Swagger UI的静态资源映射规则。
清理依赖缓存并重启
执行mvn clean install清理Maven依赖缓存，然后彻底重启应用（别用IDE的热重启），同时用浏览器无痕模式访问，避免浏览器缓存干扰。
检查依赖冲突
打开pom文件，确认没有引入旧版的springfox依赖，或者不同版本的springdoc组件（比如同时引入了springdoc-openapi-starter-webmvc-api和springdoc-openapi-starter-webmvc-ui，要保证版本完全一致）。如果有冲突依赖，直接移除或者统一版本。
查看启动日志定位问题
启动应用时，搜索日志中包含swagger-ui或Mapped的条目，确认Spring是否正确注册了/swagger-ui/**的路径映射。如果日志中没有相关映射记录，说明依赖可能未正确加载，或者配置未生效，可以尝试重新导入Maven依赖。