springdoc.swagger-ui.url配置.yaml后缀后分组API URL未自动添加后缀的问题咨询

嗨，我碰到过类似的问题，这其实是springdoc的配置逻辑细节问题，不是你哪里配错了～

先给你解释下原因：你配置的springdoc.swagger-ui.url只是用来指定Swagger UI默认加载的那个API文档路径，但分组的API文档URL是基于全局的springdoc.api-docs.path生成的，默认这个值是/v3/api-docs。所以不管你给swagger-ui.url加了什么后缀，分组路径都会自动用这个默认基础路径拼接分组名，就出现了你看到的/v3/api-docs/customer这种情况。而你手动访问/v3/api-docs.yaml/customer有效，是因为springdoc本身支持通过后缀指定返回格式（yaml/json），只是分组路径生成逻辑没用到你配置的swagger-ui.url后缀而已。

下面给你两种解决办法，你可以根据需求选择：

方法一：全局配置所有分组路径带.yaml后缀 #

如果你希望所有分组的API文档路径都自动带上.yaml后缀，直接修改全局的api-docs基础路径就行：

# 替换默认的api-docs路径为带.yaml后缀的版本
springdoc.api-docs.path=/v3/api-docs.yaml

这样不管是默认文档还是分组文档，路径都会变成/v3/api-docs.yaml或者/v3/api-docs.yaml/{groupName}，Swagger UI里的分组链接也会自动使用这个带后缀的路径，不用再单独配置swagger-ui.url了（如果需要指定默认加载的分组，再额外配置即可）。

方法二：手动指定每个分组的Swagger UI链接 #

如果你不想全局修改api-docs路径，只想让Swagger UI里的分组链接指向带后缀的路径，可以手动配置每个分组的URL：

# 配置分组的Swagger UI展示名称和对应URL
springdoc.swagger-ui.urls[0].name=Customers
springdoc.swagger-ui.urls[0].url=/v3/api-docs.yaml/customer
# 其他分组可以继续添加urls[1]、urls[2]...

这种方式更灵活，适合只需要部分分组带后缀的场景。

你可以试试这两种方法，应该就能解决你遇到的“Unable to render this definition”错误啦～

备注：内容来源于stack exchange，提问作者Walter Butze