nginx在k8s中优雅退出的关键是确保sigterm经pid 1正确传递至nginx主进程并启用master_process；需用exec格式cmd、验证ps -p 1输出为nginx master、补tini兜底，并配合prestop、readinessprobe与terminationgraceperiodseconds。
让 Nginx 在 Kubernetes 中真正优雅退出，关键不是“重启 Nginx”，而是确保 SIGTERM 能从 K8s 顺利传到 Nginx 主进程。根本症结常在容器内 PID 1 进程失职：它没转发信号，也没回收子进程，导致 Nginx 收不到终止指令，超时后被强杀（SIGKILL），连接中断、请求丢失。
确认并修复 PID 1 信号链断裂
Nginx 官方镜像默认使用 CMD ["nginx", "-g", "daemon off;"]，这是 exec 模式，Nginx 直接成为 PID 1，本身支持 SIGTERM —— 理论上没问题。但实际中常见陷阱：
- 你自定义的启动脚本（如
start.sh）被设为 ENTRYPOINT 或 CMD，此时/bin/sh占据 PID 1，它不转发 SIGTERM 给 Nginx 子进程 - 镜像构建时用了 shell 形式 CMD，例如
CMD nginx -g "daemon off;"（缺方括号），Docker 会用/bin/sh -c包裹，sh变成 PID 1 - 即使 Nginx 是 PID 1，若未启用 master process（即关闭了
master_process on;），它可能无法响应 SIGTERM
验证方法：kubectl exec -it <pod> -- ps -p 1</pod>。输出应为 nginx: master process ...，而非 sh 或 bash。
强制 Nginx 以 PID 1 运行并启用主进程
确保 Dockerfile 中使用严格 exec 格式，并显式开启 master：
-
✅ 正确写法（推荐）：
FROM nginx:alpineCOPY nginx.conf /etc/nginx/nginx.confENTRYPOINT ["nginx"]CMD ["-g", "daemon off;"] -
✅ nginx.conf 中必须包含：
master_process on;pid /var/run/nginx.pid; -
❌ 避免：
CMD ["sh", "-c", "nginx -g 'daemon off;'"]或CMD nginx -g "daemon off;"
补一层轻量 init（tini）兜底
即便你认为 Nginx 已是 PID 1，生产环境仍建议加 tini 防御性加固——它自动转发所有信号、清理僵尸进程，且几乎零开销：
- Debian/Ubuntu 基础镜像：
RUN apt-get update && apt-get install -y --no-install-recommends tini && rm -rf /var/lib/apt/lists/* - Alpine 镜像：
RUN apk add --no-cache tini - 声明入口点：
ENTRYPOINT ["/sbin/tini", "--"]，后续 CMD 不变 - 或运行时启用（不改镜像）：
kubectl run ... --overrides='{"spec":{"containers":[{"name":"nginx","args":["--init"]}]}'}'，但注意 K8s 不原生支持--init，需用securityContext.runAsUser配合或改用 initContainer 方式；更稳妥的是在 Deployment 中用args注入 tini 启动命令
配合 K8s 生命周期钩子与就绪探针
信号通了只是基础，还需 K8s 协同完成“先停流量、再等退出”闭环：
-
preStop 钩子：给 Nginx 留出缓冲时间，避免 SIGTERM 到达瞬间就断连
lifecycle:<br> preStop:<br> exec:<br> command: ["/bin/sh", "-c", "sleep 2 && nginx -s quit"]
（nginx -s quit是 Nginx 自带的优雅退出命令，比仅发 SIGTERM 更可靠） -
就绪探针（readinessProbe）：滚动更新前主动下线流量
readinessProbe:<br> httpGet:<br> path: /healthz<br> port: 80<br> initialDelaySeconds: 5<br> periodSeconds: 5
- 终止宽限期（terminationGracePeriodSeconds）：设为 30–60 秒，确保有足够时间处理存量请求和执行 preStop
