未使用注册中心的JHipster微服务无法显示Swagger UI如何解决？

基础配置校验 #

• 检查配置文件中swagger开关状态：打开application-dev.yml或对应环境的配置文件，确认springdoc.api-docs.enabled、springdoc.swagger-ui.enabled两个配置项的值均为true。JHipster默认生产环境会关闭swagger，如需要在非开发环境访问需手动修改配置开启。
• 校验接口文档生成能力：直接访问{服务访问地址}/v3/api-docs，如果该请求返回404，说明接口文档的后端生成逻辑存在异常；如果返回正常的JSON格式内容，说明问题出在Swagger UI前端资源加载环节。

路径规则校验 #

• 核对服务上下文路径配置：如果你的服务配置了server.servlet.context-path自定义上下文路径，Swagger UI的访问地址需要同步加上该前缀，例如上下文路径为/user-service时，正确访问地址为{服务地址}/user-service/swagger-ui.html。
• 检查自定义路径配置：如果之前修改过springdoc的默认路径，确认springdoc.swagger-ui.path的配置值和你访问的路径一致，默认配置值为swagger-ui.html。

权限拦截校验 #

• 确认Swagger相关资源已加入权限放行名单：如果服务集成了Spring Security，需要放行的路径包括/v3/api-docs/**、/swagger-ui/**、/swagger-ui.html、/swagger-resources/**、/webjars/**。
• 检查JHipster自带认证逻辑配置：如果使用了JHipster默认的JWT、OAuth2认证能力，需确认Security配置类的filterChain方法中已经将上述路径配置为无需认证即可访问。

对接AWS托管网关前置适配 #

如果后续要接入AWS托管网关，可提前完成以下配置避免后续Swagger再次出现异常：

• 提前将springdoc.swagger-ui.url配置为AWS网关映射后的/v3/api-docs完整访问路径，避免对接后Swagger UI请求接口文档的路径错误。
• 配置AWS网关的路径转发规则时，注意不要截断Swagger相关路径的请求，同时开启对应路径的CORS配置允许前端资源正常加载。

内容的提问来源于stack exchange，提问作者Tuhin Subhra Mandal