Spring Security集成knife4j访问接口文档出现403

原创已于 2023-07-03 22:36:22 修改 · 3.6k 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#spring #java #后端 #knife4j

于 2023-06-05 15:17:24 首次发布

常见报错专栏收录该内容

56 篇文章

订阅专栏

文章讲述了在使用SpringBoot2.3.12.RELEASE，配合knife4j和springfox-swagger2时，遇到的一个问题。每当访问/doc.html接口文档时，控制台会抛出异常，原因是尝试访问/favicon.ico而触发了自定义的认证失败处理。解决方案是在项目resources/static目录下添加favicon.ico文件，以防止系统试图从其他接口路径获取该图标。

问题描述：

使用的springboot版本是2.3.12.RELEASE，引用的依赖如下：

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-boot-starter</artifactId>
    <version>${knife4j.version}</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.10.5</version>
    <exclusions>
        <exclusion>
            <groupId>io.swagger</groupId>
            <artifactId>swagger-models</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-models</artifactId>
    <version>1.5.22</version>
</dependency>

在WebSecurityConfigurerAdapter继承类当中配置了跳过认证

@Override
public void configure(WebSecurity web) {
    web.ignoring().antMatchers("/doc.html",
            "/favicon.ico",
            "/v2/api-docs",
            "/swagger-resources/**",
            "/webjars/**");
}