记一次springboot3中swagger服务启动失败

项目开始进行升级，jDk 使用 21，springboot 使用 3 导致引入的 swagger jar 包无效，后来发现，springboot3 已经替换了支持的 jar 包。

把老 jar 包

<dependency><groupId>org.springdoc</groupId><artifactId>springdoc-openapi-ui</artifactId><version>1.6.14</version></dependency>

替换成

<dependency><groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId><version>2.3.0</version></dependency>

在 application.yml 配置

springdoc:
  swagger-ui:
    enabled: true
  api-docs:
    groups:
      enabled: true
  group-configs:
    - group: admin
      display-name: 管理后台
      paths-to-match: /admin/**

文档

springdoc-openapi-starter-webmvc-ui