Laravel POST超时需多层协同优化：Nginx的fastcgi_read_timeout、PHP-FPM的request_terminate_timeout、PHP的max_execution_time及Laravel层数据库/HTTP请求/上传限制等共同作用，盲目调高执行时间易掩盖真实瓶颈。
Laravel 中 POST 请求超时，不是单靠改 max_execution_time 就能解决的。真正起作用的是多层协同控制：PHP 脚本层、Web 服务器（如 Nginx）、PHP-FPM 网关层、以及 Laravel 自身的请求生命周期逻辑。盲目延长 PHP 执行时间，反而容易掩盖真实瓶颈，甚至引发进程堆积或内存泄漏。
先确认是哪一层在超时
常见现象和对应层级：
- 浏览器报 “504 Gateway Timeout” → Nginx 层先断开
- 页面卡住几秒后返回 500 或空白 → PHP-FPM 的
request_terminate_timeout触发 - 请求直接中断、日志里有 “Maximum execution time exceeded” → PHP
max_execution_time生效 - 请求进了 Laravel，但某条 SQL 卡住 20 秒才返回 → 数据库连接或查询超时（非 PHP 层）
Nginx 层：fastcgi_read_timeout
这是 POST 提交大文件或长处理最常被忽略的一环。默认通常只有 60 秒。
修改 Nginx 配置（如 server 块内）：
location ~ \.php$ {
fastcgi_pass php-fpm;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
# 关键：允许 PHP 脚本有足够时间响应
fastcgi_read_timeout 300; # 单位秒，建议设为比 PHP-FPM timeout 多 10~20 秒
}修改后重载：sudo nginx -s reload
PHP-FPM 层：request_terminate_timeout
它比 max_execution_time 更权威——尤其在 FPM 模式下，一旦触发，worker 进程会被强制杀掉。
编辑 php-fpm.conf 或对应 pool 配置（如 /etc/php/{version}/fpm/pool.d/www.conf）：
request_terminate_timeout = 300s ; 必须显式设置，不要留空或注释掉 ; request_slowlog_timeout = 60s ; 可选：记录慢请求到 slow.log
重启服务：sudo systemctl restart php{version}-fpm
⚠️ 注意：如果这里设为 0，表示不限制，生产环境严禁这么做。
PHP 层：max_execution_time
仅作兜底，不建议全局调高。线上建议保持 30 或 60，特殊接口单独处理。
- 全局改（不推荐）：在
php.ini中设max_execution_time = 300
- 接口级临时延长（谨慎使用）：
// 在控制器方法开头（仅限明确需要长耗时的 POST 接口） set_time_limit(300);
⚠️ 但注意：不能在队列任务中用这个，也不要在中间件里无差别调用。
Laravel 层：避免“假超时”，优先优化真瓶颈
90% 的 POST 超时，实际是以下原因：
- 数据库慢查询（没索引、N+1、
LIKE '%xxx%'） - 同步 HTTP 请求没设超时（如
file_get_contents()、未配置timeout的 Guzzle） - 大文件上传未开启流式处理或分块
- 未启用路由/配置缓存（开发模式下反复加载）
✅ 推荐做法：
- 开启慢查询监听：
DB::listen(function ($query) { if ($query->time > 500) { // 超过 500ms 记录 \Log::warning('Slow query', ['sql' => $query->sql, 'time' => $query->time]); } }); - 给外部请求加超时（Guzzle 示例）：
Http::timeout(10)->post($url, $data); // 10 秒内必须返回
- 对大表单或文件上传接口，加中间件记录耗时：
// app/Http/Middleware/LogRequestDuration.php public function handle($request, Closure $next) { $start = microtime(true); $response = $next($request); $duration = round((microtime(true) - $start) * 1000); if ($duration > 2000) { \Log::warning('Slow POST', [ 'path' => $request->fullUrl(), 'method' => $request->method(), 'ms' => $duration, ]); } return $response; }
最后检查：上传限制是否卡住
POST 超时还可能源于上传大小限制：
-
upload_max_filesize（php.ini） -
post_max_size（php.ini，需 ≥ upload_max_filesize） - Nginx 的
client_max_body_size（单位可以是10M、100M）
例如：
client_max_body_size 100M;
不复杂但容易忽略
