Swagger UI调用login端点无响应？Spring Boot JWT集成问题咨询

重命名login端点不是必需的，优先排查以下常见问题：

1. CORS预检请求未正确处理 #

Swagger UI发起请求前会先发送OPTIONS预检请求，如果后端Spring Security未放行这类请求，会导致请求挂起。

• 检查CORS配置，确保允许Swagger UI所在域名（通常是http://localhost:8080）的OPTIONS请求，同时放行Content-Type等必要请求头。
• 示例Spring Security CORS配置：

  @Bean
  public CorsConfigurationSource corsConfigurationSource() {
      CorsConfiguration config = new CorsConfiguration();
      config.setAllowedOrigins(Collections.singletonList("http://localhost:8080"));
      config.setAllowedMethods(Arrays.asList("GET", "POST", "PUT", "DELETE", "OPTIONS"));
      config.setAllowedHeaders(Arrays.asList("Authorization", "Content-Type", "Accept"));
      config.setAllowCredentials(true);
      
      UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
      source.registerCorsConfiguration("/**", config);
      return source;
  }
  

2. Swagger安全规则错误应用到Login端点 #

如果你的OpenAPI全局配置要求所有端点携带JWT，但Login端点是无需认证的，需要单独排除安全要求：

• 方法一：在接口上通过@Operation注解禁用安全校验：

  @PostMapping("/api/v1.0/auth/login")
  @Operation(security = {}) // 明确该端点不需要JWT认证
  public ResponseEntity<AuthResponse> login(@RequestBody LoginRequest loginReq) {
      // 登录逻辑实现
  }
  

• 方法二：在OpenAPI配置类中给Login端点单独设置空安全规则：

  @Bean
  public OpenAPI customOpenAPI() {
      SecurityScheme jwtScheme = new SecurityScheme()
              .type(SecurityScheme.Type.HTTP)
              .scheme("bearer")
              .bearerFormat("JWT")
              .name("bearerAuth");
      
      return new OpenAPI()
              .components(new Components().addSecuritySchemes("bearerAuth", jwtScheme))
              .security(Collections.singletonList(new SecurityRequirement().addList("bearerAuth")))
              // 排除login端点的全局安全规则
              .paths(new Paths()
                      .addPathItem("/api/v1.0/auth/login", new PathItem()
                              .post(new Operation().security(new ArrayList<>()))));
  }
  

3. 响应序列化异常 #

如果Login接口返回的对象存在循环引用或自定义序列化问题，Swagger UI解析响应时会卡住：

• 临时修改Login接口，返回一个简单JSON对象（如{"token": "dummy-token"}），测试Swagger UI是否能正常接收响应。
• 若恢复正常，排查原响应对象的序列化配置，比如添加@JsonIgnore解决循环引用问题。

4. Swagger UI自动填充无效Authorization头 #

Swagger UI可能会给所有请求自动添加Authorization头，导致Login请求携带空Token发送到后端，后端处理异常但未正确返回，引发无限加载：

• 在Swagger UI的请求编辑页，手动移除Authorization头后重新调用Login端点。
• 若成功，说明需要通过第2点的配置排除Login端点的安全要求，避免自动填充无效头。

内容的提问来源于stack exchange，提问作者mike