worker_shutdown_timeout
设置 NGINX 中工作进程优雅关闭的超时时间。 — NGINX Core
worker_shutdown_timeout
main
语法worker_shutdown_timeout time;
默认值60000
上下文main
模块NGINX Core
参数1
说明
`worker_shutdown_timeout` 指令在 NGINX 中指定在接收到终止信号后,NGINX 将等待工作进程优雅关闭的时长(以毫秒为单位)。这允许工作进程在被强制终止之前完成正在进行的请求并清理资源。在存在长连接或大型请求等可能需要额外时间完成处理的场景中,这一点尤其有用。 如果工作进程未能在指定的超时时间内完成其操作,NGINX 将强制终止这些进程。将此值设置得过低可能导致活动请求被中断,从而造成潜在的数据丢失或事务不完整;反之,设置得过高可能会延迟应用重启或关闭,影响维护或更新期间的可用性。实际上,在此处设置一个合理的值可以在服务连续性与在升级或优雅重启期间的高效资源管理之间取得平衡。
配置示例
worker_shutdown_timeout 30000; # Set a 30 seconds timeout for worker shutdown
⚠
将超时时间设置得过低可能导致正在进行的请求被异常终止。
⚠
未设置此指令可能导致使用默认超时时间,而默认值可能不适合所有应用程序。