Nginx 配置语法检查如何检查跨域配置错误
使用 nginx -t 命令可以验证 nginx 配置文件的语法正确性,但它无法直接检测逻辑层面的跨域(cors)配置错误。要确保跨域配置生效且无错误,需要结合配置文件中的 add_header 指令与浏览器开发者工具或 curl 命令行进行实际请求测试。

如何通过 curl 验证预检请求响应头
通过 curl -I 发送 OPTIONS 预检请求,检查返回的 HTTP 状态码是否为 204 或 200,并确认响应头中包含 Access-Control-Allow-Origin、Access-Control-Allow-Methods 等关键字段。如果这些字段缺失或值不正确,即为跨域配置错误。

curl -I -X OPTIONS http://localhost/api/test -H "Origin: http://example.com" -H "Access-Control-Request-Method: POST" -H "Access-Control-Request-Headers: Content-Type"
如何处理动态 Origin 导致的跨域失败
当 Nginx 配置中使用 $http_origin 变量来动态设置 Access-Control-Allow-Origin 时,必须配合 map 模块或条件判断来处理空值或非法来源,否则可能导致浏览器拒绝请求或安全漏洞。

location /api/ {
add_header 'Access-Control-Allow-Origin' $http_origin always;
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range' always;
if ($request_method = 'OPTIONS') {
return 204;
}
}











