升级Spring Boot 3后Swagger UI失效及依赖冲突如何解决？

问题1：Swagger UI 访问返回404白页 #

升级至Spring Boot 3后，访问Swagger UI时出现404错误及White Label默认页面。

解决步骤 #

将原springdoc依赖替换为适配Spring Boot 3的starter版本：

• 移除旧依赖：

  implementation(group: 'org.springdoc', name: 'springdoc-openapi-ui', version: '1.5.8')
  

• 添加新依赖：

  implementation(group: 'org.springdoc', name: 'springdoc-openapi-starter-webmvc-ui', version: '2.0.3')
  

替换后重新启动项目，Swagger UI即可正常访问。

问题2：依赖冲突导致访问/v3/api-docs/返回500错误 #

部分项目替换依赖后，访问/v3/api-docs/接口时抛出500内部错误，经排查是依赖版本冲突导致：
io.confluent:kafka-avro-serializer:7.3.1与springdoc-openapi-starter-webmvc-ui:2.0.3均依赖io.swagger.core.v3:swagger-annotations-jakarta，但二者依赖的版本不一致。

解决步骤 #

在Gradle构建脚本中强制指定该依赖的统一版本：

configurations.all {
    resolutionStrategy.force 'io.swagger.core.v3:swagger-annotations-jakarta:2.2.8'
}

配置完成后重新构建项目，500错误即可消除。

内容的提问来源于stack exchange，提问作者clever-developer