Windows下Nginx平滑退出需用nginx -s quit指令，或通过NSSM注册服务并配置其执行该命令；直接Ctrl+C、关闭窗口或taskkill会导致非平滑终止。
在 Windows 下，Nginx 本身不以 Windows 服务方式原生运行，因此“停止服务时平滑退出”需分两种情况处理：一种是手动以控制台进程方式运行 Nginx，另一种是通过第三方工具（如 srvany 或 NSSM）将其注册为 Windows 服务。真正的“平滑退出”（即等待当前请求处理完成后再关闭）在 Windows 上受限于系统信号机制，但可通过正确操作最大限度减少连接中断。
确认 Nginx 运行方式
Windows 不支持 Unix 类系统的 SIGQUIT 或 SIGTERM 信号，所以直接按 Ctrl+C 在命令行中终止 Nginx 主进程，会触发快速退出，可能中断正在传输的响应。要实现接近平滑的效果，需先发送 重新加载配置指令（该操作本身会启动新工作进程、逐步关闭旧进程），或使用 -s 参数向已运行实例发指令：
- 确保 Nginx 正在运行（例如通过
nginx -t验证配置后执行start nginx） - 打开新命令行窗口，进入 Nginx 安装目录（如
D:\nginx） - 执行：
nginx -s quit—— 这是 Windows 下最接近“平滑退出”的方式，主进程会通知工作进程处理完当前请求后安全退出 - 若提示“nginx: [error] open() 'nginx.pid' failed”，说明未生成 pid 文件，可改用
nginx -s stop（强制停止，不等待请求完成）
若已注册为 Windows 服务（推荐用 NSSM）
使用 NSSM 注册 Nginx 为服务后，它能更可靠地接管进程生命周期。此时“停止服务”实际由 NSSM 转发为 nginx -s quit 指令：
- 安装 NSSM 后，用其创建服务，在 “Service” 页设置 “Startup directory” 为 Nginx 目录
- 在 “Details” 页填写：Display name（如 Nginx Web Server）、Description
- 关键一步：在 “Settings” 页勾选 “Stop service with ‘nginx -s quit’”（或在 “Shutdown” 页自定义 shutdown command 为
nginx -s quit） - 之后通过
net stop nginx或服务管理器停止服务，NSSM 就会执行平滑退出流程
验证是否真正平滑退出
平滑退出无法 100% 保证零连接丢弃（尤其长连接或流式响应），但可通过以下方式观察效果：
- 启动 Nginx 后，用浏览器或
curl发起一个慢请求（例如访问一个大文件或加了sleep(5)的后端） - 立即在另一窗口执行
nginx -s quit - 观察该请求是否成功完成（而非报 connection reset / broken pipe）
- 检查 Nginx 日志（
logs/error.log）末尾是否有signal 3 (SIGQUIT) received, exiting和exit记录，表明主进程有序终止
不建议的操作
以下方式会导致非平滑、甚至损坏状态：
- 直接在 Nginx 控制台窗口点关闭按钮（×）—— 强制终止，无任何清理
- 任务管理器中结束
nginx.exe进程树 —— 可能残留 worker 进程或锁住端口 - 用
nginx -s stop替代quit—— 立即终止所有连接，等同于 kill -9 - 未配置
pid文件路径（nginx.conf中pid logs/nginx.pid;）导致-s指令失效
