自定义openapi文档不能应用于springdoc-openapi-ui web视图。

Question

我试图在现有json配置的基础上设置swagger，使用'org.springdoc:springdoc-openapi-ui:1.5.9'依赖项(spring + gradle)。

我拥有的是：

• 在我的“资源/静态”文件夹中自定义openapi.json文件
• 我的属性中的springdoc.swagger-ui.url=openapi.json

根据文档的说法，这应该就足够了

​

​

但我在试图打开swagger-ui.html时遇到了一个问题，它写着“获取错误未定义的openapi.json"：

查看浏览器开发工具和请求，我发现以下请求：

​

​

因此，它使用/swagger/ in路径，无法到达资源。我的openapi.json可用简单的http://localhost:8080/openapi.json，但w/o前缀。

我尝试在“静态”下创建“swagger”dir，但是它没有帮助，文件在以前的位置仍然可以访问。

我也尝试设置springdoc.api-docs.path，但是它也没有帮助，它只改变了生成的api位置。

Answer 1

正如海伦提到的，重要的是要把这条路放在前面

将属性更改为springdoc.swagger-ui.url=/openapi.json解决了问题！