Angular对接Spring Boot测试环境出现CORS跨域问题求解决方案

根因初步判定 #

你遇到的CORS报错是表象，核心问题是OPTIONS预检请求被Nginx网关拦截/转发超时返回504，没有到达Spring Boot服务，因此无法返回符合CORS规则的200响应。本地环境无Nginx转发层，所以CORS配置生效、请求正常。

排查步骤 #

1. 验证预检请求链路 #

本地执行curl命令直接请求测试环境接口，校验OPTIONS请求返回：

curl -v -X OPTIONS https://jdapi-dev.xxxx.tech/api/v1/userManagement/jdUser/JD2343/active \
-H "Origin: https://jdfront-test.heptagon.tech" \
-H "Access-Control-Request-Method: PUT"

若返回504，直接进入网关层排查；若返回200但缺少CORS响应头，再校验Spring Boot配置。

2. 网关（Nginx）配置排查 #

• 校验OPTIONS请求转发规则：确认Nginx没有默认拦截OPTIONS请求直接返回，所有OPTIONS请求都正确转发到上游Spring Boot服务
• 调整超时配置：Nginx默认proxy_connect_timeout/proxy_send_timeout/proxy_read_timeout为60s，若接口响应耗时较长，将三个参数调整为120s以上
• 校验上游服务配置：确认Nginx配置的Spring Boot服务内网IP、端口正确，测试环境后端服务正常运行，防火墙未拦截Nginx到后端的流量
• 移除重复CORS配置：不要同时在Nginx和Spring Boot两层配置CORS规则，只保留一处即可，避免重复响应头导致CORS校验失败

3. Spring Boot配置优化 #

当前配置缺少必要参数，高版本Spring Boot和带自定义头的请求会触发校验失败，替换为以下配置：

@Configuration
@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                // 高版本Spring Boot使用allowedOriginPatterns代替allowedOrigins，兼容性更强
                .allowedOriginPatterns("*")
                .allowedMethods("PUT", "GET", "DELETE", "OPTIONS", "PATCH","POST")
                // 允许所有自定义请求头，前端带Authorization等自定义头时可正常通过校验
                .allowedHeaders("*")
                // 未使用Cookie/会话凭证时设为false，与通配符源规则兼容
                .allowCredentials(false)
                // 缓存预检请求结果1小时，减少重复OPTIONS请求开销
                .maxAge(3600);
    }
}

如果项目引入了Spring Security，额外新增OPTIONS请求放行规则：

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.cors().and()
            .authorizeRequests()
            // 放行所有OPTIONS预检请求
            .antMatchers(HttpMethod.OPTIONS, "/**").permitAll()
            // 其余原有权限配置保持不变
            .anyRequest().authenticated()
            .and().csrf().disable();
    }
}

4. 后端服务可用性校验 #

登录测试环境服务器，直接向内网Spring Boot服务发起请求，确认业务接口本身可用：

curl -v -X PUT http://{后端服务内网IP}:{服务端口}/api/v1/userManagement/jdUser/JD2343/active

若该请求超时或报错，优先排查后端业务逻辑、数据库/依赖服务的可用性问题。

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