springboot3使用swagger3

只需要添加依赖,其他什么都不需要即可使用

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

springboot版本为3.2.8

然后直接访问http://localhost:8080/swagger-ui/index.html#/ 即可

### Spring Boot 3 中配置 Swagger 3 实现接口文档正常访问 为了使 Spring Boot 3Swagger 3 正常工作并放行接口文档的访问,需要按照特定的方式添加依赖项和配置。 #### 添加 Maven 依赖 对于 Spring Boot 3 版本,推荐使用 `springdoc-openapi` 来替代旧版的 `springfox` 库。以下是适用于 Spring Boot 3 的正确依赖声明: ```xml <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId> <version>2.0.4</version> </dependency> ``` 此依赖会自动配置大多数必要的组件来启动 OpenAPI UI 页面[^1]。 #### 编写配置类 (可选) 通常情况下不需要额外编写配置类,因为 `springdoc-openapi` 已经提供了默认配置。如果确实有自定义需求,则可以通过创建一个 Java 配置文件来进行调整: ```java import org.springframework.context.annotation.Configuration; import io.swagger.v3.oas.models.OpenAPI; import io.swagger.v3.oas.models.info.Info; @Configuration public class SwaggerConfig { @Bean public OpenAPI customOpenAPI() { return new OpenAPI() .info(new Info().title("My API").version("v1")); } } ``` 这段代码用于设置 API 文档的基础信息,比如标题和版本号[^2]。 #### 安全配置中的路径排除 当应用集成了安全框架如 Spring Security 后,需确保 `/swagger-ui.html` 或者新的默认 URL 路径 `/v3/api-docs/**`, `/swagger-ui/index.html` 不被拦截器保护起来。可以在 WebSecurityConfigurerAdapter 继承的安全配置中加入如下规则: ```java @Override protected void configure(HttpSecurity http) throws Exception { http.authorizeRequests() .antMatchers("/v3/api-docs/**", "/swagger-ui/**").permitAll() .anyRequest().authenticated(); } ``` 这一步骤非常重要,它允许未认证用户也能浏览 API 文档页面[^3]。 通过以上步骤可以成功地在 Spring Boot 3 上部署并开放访问 Swagger 接口文档的功能。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值