要让Windows下Nginx 1.30.5稳定对接PHP 8.4.1并支持大文件上传或长耗时脚本，必须同步协调Nginx、FastCGI通信与客户端请求三端超时参数：PHP层设max_execution_time=1800、upload_max_filesize=2048M；Nginx层配client_max_body_size=2048m、client_body_timeout=600；FastCGI层设fastcgi_read_timeout=1800且与PHP执行时限对齐，漏配任一环将触发408、504或连接中断。
要让 Windows 下的 Nginx 1.30.5 稳定对接 PHP 8.4.1 并支持大文件上传或长耗时脚本（比如数据导入、报表导出），不能只改 PHP 配置，必须同步协调 Nginx、FastCGI 通信、客户端请求三端的超时参数。漏配任意一环，都会触发 408、504 或连接中断。
PHP 层：延长脚本执行与输入解析时限
进入宝塔面板或直接编辑 php.ini（路径如 D:\php84\php.ini），确保以下参数生效：
- max_execution_time = 1800 —— 脚本最长运行时间（单位秒），覆盖导出、AI推理等场景
- max_input_time = 1800 —— 表单数据和文件上传内容解析总时限，必须 ≥ upload_max_filesize 处理所需时间
- upload_max_filesize = 2048M 和 post_max_size = 2048M —— 后者需略大于前者，避免 POST 数据被截断
- memory_limit = 2G（可选）—— 防止大文件读入或数组处理时内存溢出
Nginx 客户端请求超时：控制浏览器到 Nginx 的交互
在站点配置文件（如 nginx.conf 的 server 块内）添加或修改以下指令：
- client_max_body_size 2048m —— 允许客户端上传最大 2GB 请求体，不设此项，大文件直接 413 错误
- client_header_timeout 600 —— 等待完整 HTTP 请求头（如 GET /xxx HTTP/1.1）最多 10 分钟，公网弱网下建议 30–60 秒，调试期可放宽
- client_body_timeout 600 —— 请求头收完后，两次接收 POST 数据包之间的空闲等待上限，不是总上传时长，但影响断点续传稳定性
- send_timeout 600 —— Nginx 向浏览器发响应时，两次 write 操作间隔不能超此值；适用于生成大 HTML 或流式响应
FastCGI 通信超时：Nginx ↔ PHP-FPM 的关键桥梁
在 location ~ \.php$ 区块内，必须显式配置 FastCGI 超时项（默认值往往过短，易引发 504）：
立即学习“PHP免费学习笔记（深入）”；
- fastcgi_connect_timeout 300 —— Nginx 连接 PHP-FPM 的 TCP 建立时限，Windows 下网络栈延迟稍高，建议 ≥ 5 秒
- fastcgi_send_timeout 1800 —— Nginx 向 PHP-FPM 发送完整请求（含大 POST body）的总耗时上限
- fastcgi_read_timeout 1800 —— Nginx 等待 PHP-FPM 返回响应的最长时间，这是解决 504 Gateway Timeout 最核心的参数
注意：fastcgi_read_timeout 应与 PHP 的 max_execution_time 对齐，且不能超过后端真实处理能力，否则只是掩盖问题。
额外检查项（常被忽略）
Windows 环境下还需确认：
- PHP-FPM 是否实际运行？用
tasklist | findstr php-cgi查看进程；若用php-cgi.exe -b 127.0.0.1:9000启动，确保端口未被占用 - Nginx 配置中
fastcgi_pass地址与 PHP-FPM 监听地址严格一致（127.0.0.1:9000或unix:/path/to/php.sock） - 禁用
suhosin等安全扩展（PHP 8.4 已不兼容，若残留会导致上传静默失败） - 验证生效：创建
phpinfo.php，访问后搜索关键词确认各项参数已更新
