在 linux 中调整 nginx 平滑重载时的请求超时，核心方法是修改配置文件中的 worker_shutdown_timeout 参数。该参数定义了 nginx 在收到停止信号后，等待当前正在处理的请求完成的最长时间；超过此时间后，nginx 将强制关闭连接。设置完成后，通过执行 nginx -s reload 命令触发重载，即可使新配置生效。
如何配置 worker_shutdown_timeout 参数
要解决平滑重载时的超时问题，需要在 Nginx 的主配置文件（通常是 nginx.conf）中添加或修改 worker_shutdown_timeout 指令。这个指令的值以时间单位表示，例如 10s 代表 10 秒，1m 代表 1 分钟。默认情况下，如果没有设置该参数，Nginx 会立即关闭连接，这可能导致正在进行的请求中断。因此，根据业务需求设置一个合理的超时值是关键。
events {
worker_connections 1024;
}
http {
# 设置工作进程优雅关闭的超时时间为 30 秒
worker_shutdown_timeout 30s;
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
}
}
}
在上述配置中，worker_shutdown_timeout 30s; 确保了当 Nginx 接收到重载或停止信号时，它会等待最多 30 秒让现有的请求处理完毕。如果 30 秒后仍有请求未完成，Nginx 将强制终止这些连接并退出。这种机制避免了因突然关闭连接而导致的客户端错误，如 502 Bad Gateway 或 504 Gateway Timeout。
重载配置后的行为验证
配置好 worker_shutdown_timeout 后，需要验证其是否按预期工作。可以通过模拟长耗时请求来测试 Nginx 的重载行为。首先，启动一个缓慢响应的后端服务，然后向 Nginx 发送请求。接着，执行 nginx -s reload 命令。观察 Nginx 的错误日志和客户端响应，确认请求是否在设定的超时时间内得到处理，或者在超时后被强制关闭。
# 模拟一个慢速后端服务 python3 -m http.server 8080 --bind 127.0.0.1 && sleep 60 && kill %1 # 向 Nginx 发送请求 wget -qO- http://localhost/
在验证过程中，如果发现请求在重载后立即中断，说明 worker_shutdown_timeout 可能未正确设置或未被加载。检查 Nginx 的错误日志（通常为 error.log），查看是否有相关警告或错误信息。确保配置文件语法正确，并使用 nginx -t 命令测试配置文件的合法性。如果配置无误但行为不符，考虑重启 Nginx 服务而非仅重载，以确保所有配置项被重新读取。
基于 worker_shutdown_timeout 的具体超时影响
当 worker_shutdown_timeout 设置为特定值时，它对正在处理的请求有直接影响。例如，如果设置为 10s，而某个请求的处理时间超过 10 秒，那么在重载时，该请求将在 10 秒后被强制终止。这意味着客户端可能会收到一个不完整的响应或连接重置错误。因此，设置该参数时，应考虑到最坏情况下的请求处理时间，并留出一定的缓冲时间。
,
