Spring Boot应用无法在浏览器中设置HTTP Cookie（React调用场景）

我之前也碰到过一模一样的坑！这种情况90%都是跨域配置或者前端请求参数没到位导致的，咱们一步步来排查解决：

1. 先排查跨域(CORS)配置问题 #

因为React和Spring Boot大概率是跨域部署的（比如前端在localhost:3000，后端在localhost:8080），浏览器的同源策略会限制Cookie的跨域设置。你必须确保Spring Boot的CORS配置允许携带凭证，而且不能用*作为允许的源（带凭证时通配符不生效）。

方案1：在控制器上添加注解 #

直接在你的API控制器方法或类上添加@CrossOrigin注解：

@CrossOrigin(origins = "http://localhost:3000", allowCredentials = "true")
@RestController
public class YourController {
    // 你的API方法
}

方案2：全局CORS配置 #

如果有多个控制器，推荐全局配置，避免重复代码：

@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOrigins("http://localhost:3000") // 替换成你的React应用地址
                .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS")
                .allowCredentials(true)
                .maxAge(3600);
    }
}

2. 确保前端请求携带凭证 #

光后端配置好还不够，前端发起请求时必须明确告诉浏览器要携带Cookie凭证，否则浏览器会自动忽略响应里的Cookie。

如果你用Axios： #

axios.get('http://localhost:8080/your-api', {
    withCredentials: true
})

如果你用原生Fetch： #

fetch('http://localhost:8080/your-api', {
    method: 'GET',
    credentials: 'include' // 关键配置
})

3. 修正Cookie的MaxAge参数 #

注意一个小细节：Cookie.setMaxAge()的参数是秒数，不是毫秒！你代码里写的60*30*1000会把Cookie有效期设成1800000秒（约500小时），虽然这不会直接导致Cookie不生效，但如果你的预期是30分钟，应该改成：

cookie.setMaxAge(60*30); // 30分钟，单位为秒

4. 额外检查项 #

• 确认浏览器没有禁用Cookie，或者处于隐私模式（部分隐私模式会限制第三方Cookie）
• 如果前端和后端是不同子域名（比如frontend.example.com和api.example.com），需要给Cookie设置Domain：cookie.setDomain(".example.com");，这样子域名之间可以共享Cookie

按照上面的步骤调整后，再测试一下，应该就能看到浏览器成功设置Cookie了！

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