pangforFC 发表于 2023-12-5 15:18:33

swagger3访问文档报304错误

在springboot2.7.17中整合swagger3,但在浏览器访问http://localhost:8088/swagger-ui/index.html地址时,会自动跳转到http://localhost:8088/swagger-ui/index.html#/login?redirect=%2Fdashboard登录页面,并且报304状态
搜索大多说是被spring security拦截了,但是我只引入了加密组件:
                <!--加密组件-->
                <dependency>
                        <groupId>org.springframework.security</groupId>
                        <artifactId>spring-security-core</artifactId>
                </dependency>
配置类如下:
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.oas.annotations.EnableOpenApi;
import springfox.documentation.service.*;
import springfox.documentation.spi.service.contexts.SecurityContext;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.builders.RequestHandlerSelectors;

import java.util.Collections;
import java.util.List;


@Configuration
@EnableOpenApi
@EnableWebMvc
public class MySwaggerConfig {
    @Bean
    public Docket api() {
      return new Docket(DocumentationType.OAS_30)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.application.server"))
                .paths(PathSelectors.any())
                .build()
                .securitySchemes(Collections.singletonList(securityScheme()))
                .securityContexts(Collections.singletonList(securityContext()));
    }

    private SecurityScheme securityScheme() {
      //return new ApiKey("Authorization", "Authorization", "header");
      return new ApiKey("X-Token", "X-Token", "header");
    }

    private SecurityContext securityContext() {
      return SecurityContext.builder()
                .securityReferences(defaultAuth())
                .forPaths(PathSelectors.regex("^(?!auth).*$"))
                .build();
    }

    private List<SecurityReference> defaultAuth() {
      AuthorizationScope authorizationScope = new AuthorizationScope("global", "accessEverything");
      AuthorizationScope[] authorizationScopes = new AuthorizationScope;
      authorizationScopes = authorizationScope;
      return Collections.singletonList(
                new SecurityReference("X-Token", authorizationScopes));
    }

    private ApiInfo apiInfo() {
      return new ApiInfoBuilder()
                .title("管理系统接口文档")
                .description("SpringBoot+Vue前后端分离项目")
                .version("1.0")
                .contact(new Contact("111", "https://111.com", "xxxx@aliyun.com"))
                .build();
    }
}
请问应该如何解决

FishC_GPT 发表于 2023-12-5 15:19:19

根据您提供的信息,您遇到的问题可能是由于缓存导致的304错误。304状态码表示请求的资源在服务器上没有修改,因此服务器不会返回该资源的内容,而是告诉浏览器使用缓存。

要解决这个问题,可以尝试以下几种方法:

1. 清除浏览器缓存:在浏览器中按下Ctrl + Shift + Delete组合键,然后选择清除缓存。然后重新打开Swagger文档页面,看是否能够正常访问。

2. 修改swagger-ui的URL:在您的配置类中,尝试更改`.pathMapping("/")`来修改Swagger-UI的URL路径,代码如下所示:

@Configuration
@EnableOpenApi
@EnableWebMvc
public class MySwaggerConfig {
    @Bean
    public Docket api() {
      return new Docket(DocumentationType.OAS_30)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.application.server"))
                .paths(PathSelectors.any())
                .build()
                .securitySchemes(Collections.singletonList(securityScheme()))
                .securityContexts(Collections.singletonList(securityContext()))
                .pathMapping("/");// 添加这行代码
    }

    // ...其他代码...
}

3. 禁用浏览器缓存:在Swagger页面的HTML标签中添加以下meta标签,以禁用浏览器缓存。

<meta http-equiv="Pragma" content="no-cache">
<meta http-equiv="Cache-Control" content="no-cache">
<meta http-equiv="Expires" content="0">

在Swagger的HTML模板中找到`<head>`标签,在其中添加上述三行代码即可。

希望以上方法能够帮助您解决问题。如果仍然无法解决,建议检查您的项目中是否有其他与缓存相关的配置或拦截器,并排查其中是否存在问题。

以上回复来自 -- ChatGPT(FishC官方接口),如未能正确解答您的问题,请继续追问。
页: [1]
查看完整版本: swagger3访问文档报304错误