文件上传接口需单独配置Nginx：1.为/upload/路径显式设置CORS响应头并处理OPTIONS预检；2.增大client_max_body_size等请求体限制；3.延长proxy_send_timeout和proxy_read_timeout等代理超时参数。
文件上传接口本身不直接涉及 CORS 响应头的“超时”设置——CORS 是浏览器端的安全机制，不定义或控制超时；真正需要单独调大超时的是 Nginx 与后端服务之间通信的代理超时参数，以及客户端请求体大小限制。所谓“针对文件上传接口单独配置更大超时的跨域请求响应策略”，本质是在启用 CORS 的前提下，为 /upload/ 类路径做三件事：开放跨域、放宽请求体限制、延长代理等待时间。
1. 单独为上传路径开启 CORS 并允许必要头字段
在对应 location /upload/ 块中显式添加跨域响应头，避免继承全局宽松策略（如 * 不支持凭证），也防止 OPTIONS 预检失败：
-
add_header Access-Control-Allow-Origin "https://your-frontend.com";（不可用*若带 Cookie） -
add_header Access-Control-Allow-Methods "POST, OPTIONS";（上传通常只需 POST + 预检 OPTIONS） add_header Access-Control-Allow-Headers "Content-Type, Authorization, X-Requested-With";-
add_header Access-Control-Allow-Credentials "true";（如需携带 Cookie） - 显式处理预检请求：
if ($request_method = 'OPTIONS') { add_header Access-Control-Allow-Origin "https://your-frontend.com"; add_header Access-Control-Allow-Methods "POST, OPTIONS"; add_header Access-Control-Allow-Headers "Content-Type, Authorization"; add_header Access-Control-Allow-Credentials "true"; add_header Access-Control-Max-Age 86400; add_header Content-Length 0; add_header Content-Type text/plain; return 204; }
2. 单独放宽该路径的请求体大小限制
默认 client_max_body_size 是 1MB，上传文件极易触发 413 错误。必须在 location /upload/ 内覆盖：
-
client_max_body_size 2G;（根据业务设为 500M、1G 或更高，单位支持m、g） -
client_body_buffer_size 4m;（缓冲区建议设为带宽适配值，减少磁盘写入） - 若上传过程慢（如弱网），同步调高
client_body_timeout 300s;（限制两次数据包间隔，非总上传时长）
3. 单独延长该路径的代理超时时间
大文件上传+后端处理（如转码、校验、存 OSS）耗时长，需拉长 Nginx 等待后端响应的时间，否则返回 504：
-
proxy_connect_timeout 30s;（建立连接，一般够用） -
proxy_send_timeout 600s;（Nginx 向后端发完完整请求的上限，含大 body 传输） -
proxy_read_timeout 1800s;（Nginx 等待后端返回响应的总空闲时长，报表/导出类可设到 3600s） - 注意：这些只在当前
location生效，不影响其他接口
4. 完整示例配置片段
把以上整合进你的 server 块中：
location /upload/ {
proxy_pass http://backend;
<pre class="brush:php;toolbar:false;"># CORS 头
add_header Access-Control-Allow-Origin "https://your-frontend.com";
add_header Access-Control-Allow-Methods "POST, OPTIONS";
add_header Access-Control-Allow-Headers "Content-Type, Authorization";
add_header Access-Control-Allow-Credentials "true";
# 预检处理
if ($request_method = 'OPTIONS') {
add_header Access-Control-Allow-Origin "https://your-frontend.com";
add_header Access-Control-Allow-Methods "POST, OPTIONS";
add_header Access-Control-Allow-Headers "Content-Type, Authorization";
add_header Access-Control-Allow-Credentials "true";
add_header Access-Control-Max-Age 86400;
add_header Content-Length 0;
add_header Content-Type text/plain;
return 204;
}
# 文件上传专项限制
client_max_body_size 2G;
client_body_buffer_size 4m;
client_body_timeout 300s;
# 代理超时
proxy_connect_timeout 30s;
proxy_send_timeout 600s;
proxy_read_timeout 1800s;}
修改后务必执行 nginx -t 校验语法，再 nginx -s reload 生效。
