spirnboot swagger和knife4j jwt

访问地址

swagger:http://ip:8003/extra/swagger-ui/index.html#/

knife4j:http://127.0.0.1:8003/extra/doc.html

jwt参考链接:

https://www.cnblogs.com/wt7018/p/18867070

需要配和全局异常

https://www.cnblogs.com/wt7018/p/18871845

导入依赖:

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

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
    <version>4.5.0</version>
</dependency>

2、配置openapi

在类上加注解,swagger比较麻烦,knife4j比较简单

@SecuritySchemes({
        @SecurityScheme(
                name = "token",
                type = SecuritySchemeType.HTTP,
                scheme = "bearer",
                bearerFormat = "JWT"
        )
})

swagger使用

1、[Authorize] 按钮 → 输入框显示 "Value: Bearer <token>"

2、在需要token验证的接口上

@Operation(summary = "获取敏感数据", security = @SecurityRequirement(name = "token"))

3、忽略

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Autowired
    private AuthenticationInterceptor authenticationInterceptor;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(this.authenticationInterceptor)
                .excludePathPatterns(
                        "/swagger-ui/**",
                        "/v3/api-docs/**",
                        "/doc.html/**"
                );
    }
}

 

posted @ 2025-07-01 19:33  市丸银  阅读(18)  评论(0)    收藏  举报