Laravel项目中为Web与API路由设置不同超时的方法咨询

嘿，我之前也踩过Laravel路由单独设置超时的坑，给你分享几个亲测有效的方案，先帮你理清为什么之前的中间件方法没生效：

如果你的Laravel用的是PHP-FPM环境，单独在中间件里调用set_time_limit()大概率会失效：

• PHP-FPM的全局配置php.ini里的max_execution_time会直接覆盖这个函数的设置；
• 另外FPM本身还有request_terminate_timeout参数，会强制终止超时的进程，优先级比应用层的函数更高；
• 要是Web和API请求走的是同一个FPM进程池，全局超时设置会统一生效，自然没法区分路由类型。

你现在尝试的Nginx配置思路是对的，只要通过location匹配区分Web和API路由，分别设置超时参数就行，给你一份可直接参考的配置示例（测试时把数值改成1就行）：

server {
    listen 80;
    server_name your-domain.com;
    root /path/to/laravel/public;

    # 匹配Web路由（非/api开头的所有请求）
    location / {
        try_files $uri $uri/ /index.php?$query_string;
        # Web路由超时设置（示例为10秒，测试改1）
        fastcgi_read_timeout 10s;
        fastcgi_send_timeout 10s;
    }

    # 匹配API路由（所有/api开头的请求）
    location /api {
        try_files $uri $uri/ /index.php?$query_string;
        # API路由超时设置（示例为30秒）
        fastcgi_read_timeout 30s;
        fastcgi_send_timeout 30s;
    }

    # 通用PHP-FPM转发配置，别漏了
    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; # 换成你的FPM sock路径，TCP方式就写127.0.0.1:9000
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }
}

这里要注意：fastcgi_read_timeout是Nginx等待PHP-FPM返回响应的时间，fastcgi_send_timeout是Nginx向PHP-FPM发送请求的超时，两个参数都要设置才能生效。

如果想从PHP进程层面更精准地隔离超时规则，可以给API路由单独分配一个FPM进程池：

1. 复制一份PHP-FPM的默认池配置（比如www.conf），命名为api.conf；
2. 在api.conf里设置request_terminate_timeout = 30s，默认的www.conf保持request_terminate_timeout = 10s；
3. 重启PHP-FPM后，在Nginx的两个location里分别指定不同的FPM池：
   • Web路由的location用fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
   • API路由的location用fastcgi_pass unix:/var/run/php/php8.2-fpm-api.sock;
     这种方式相当于从Nginx和PHP双层面设置超时，比单一配置更彻底。

可以写两个测试路由快速验证：

• Web路由：

Route::get('/test-web-timeout', function () {
    sleep(2); // 如果Web超时设1秒，这里会触发超时
    return response('Web timeout test');
});

• API路由：

Route::get('/api/test-api-timeout', function () {
    sleep(2); // API超时设3秒的话，会正常返回
    return response('API timeout test');
});

用curl访问这两个路由，看是否符合预期的超时行为就行。

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