数据库容器优雅关闭的核心是先停写入、再等处理、最后关进程；必须确保主进程为pid 1（用exec模式而非shell启动），配置足够停止宽限期（如60秒），并配合prestop钩子主动拒绝新连接、清理会话及确认wal/日志落盘。
数据库容器的优雅关闭，核心是“先停写入、再等处理、最后关进程”，不能简单发个 SIGTERM 就完事。它比普通应用更敏感——连接未断干净会卡住事务，强制杀掉可能丢数据或损坏 WAL 日志。
确保主进程能收到 SIGTERM
很多数据库镜像（如 PostgreSQL 官方镜像）默认用 postgres 作为 PID 1，天然支持信号捕获；但若你用 shell 启动（比如 sh -c "postgres -D /data"），信号会被 shell 拦截，真正进程收不到。必须用 exec 替换 shell：
- 在 Dockerfile 中写成：
CMD ["postgres", "-D", "/data"]，而非CMD sh -c "postgres -D /data" - 或显式用 exec：
CMD exec postgres -D /data
配置合理的停止宽限期
数据库关闭不是秒级操作：PostgreSQL 要执行 checkpoint、刷脏页、归档未提交事务；MySQL InnoDB 需完成 purge、flush buffer pool。默认 10 秒（Docker）或 30 秒（K8s）往往不够。
- Docker 运行时加：
--stop-timeout=60 - Kubernetes 中设置：
terminationGracePeriodSeconds: 60 - 对 PostgreSQL，还可调大
shutdown_timeout（通过pg_ctl stop -t控制，但容器内通常由启动脚本封装）
主动拒绝新连接 + 等待活跃会话退出
光靠信号不够，得让数据库自己“配合”下线：
- PostgreSQL：在收到 SIGTERM 后，会进入“smart shutdown”模式——拒绝新连接，但允许已有会话继续运行直到完成。你可以提前执行
SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE state = 'idle in transaction';清理挂起事务 - MySQL：可先执行
SET GLOBAL read_only = ON;阻止写入，再用SHOW PROCESSLIST查看并 kill 长时间空闲连接 - 建议在 preStop 钩子里加轻量级清理逻辑，比如调用
curl http://localhost:8080/health/ready确认服务已标记为不可用，再发 shutdown 命令
持久化与日志确认机制
优雅关闭的终点不是进程退出，而是数据落盘可靠：
- PostgreSQL：检查
pg_controldata输出中Latest checkpoint location是否更新，且pg_wal目录无 pending 日志 - MySQL：确认
innodb_shutdown_mode = 1（默认），保证完整 flush；查看 error log 最后一行是否含Shutdown completed - 容器退出前，可加简单健康检查脚本：
while pg_isready -q; do sleep 1; done || echo "DB shut down"
