docker compose通过命名卷+生命周期钩子可实现微服务故障现场“秒级留存”：命名卷独立于容器生命周期，确保异常退出后数据仍保留在/var/lib/docker/volumes/xxx/_data；配合sigterm处理、localtime挂载和自动化归档脚本，支持跨环境一致、可信、安全的根因分析。
微服务故障发生时，保留原始运行现场（如内存快照、日志缓冲、临时状态文件）是根因分析的关键。单纯靠 docker logs 或容器重启会丢失大量瞬态信息。通过 Docker Compose 的卷挂载方案，可让故障容器在退出前将关键现场数据自动落盘到宿主机，实现“秒级留存”，无需人工介入或额外工具。
用命名卷 + 容器生命周期钩子固化现场
命名卷（named volume）比绑定挂载更可靠，它独立于容器生命周期，即使容器异常退出，数据仍保留在 /var/lib/docker/volumes/xxx/_data 中。配合容器内轻量级退出处理逻辑，即可捕获现场：
- 在
docker-compose.yml中为服务定义专用命名卷，例如service-state - 容器启动时，将该卷挂载到应用可写路径（如
/app/state） - 应用代码中注册
SIGTERM或SIGINT处理函数，在收到终止信号时，立即将堆栈、goroutine 状态、未刷盘日志等写入该路径 - 容器崩溃或被
docker stop终止时，数据已持久化，随时可检查
绑定挂载宿主机调试目录用于快速取证
开发或预发环境可启用更激进的现场留存策略：直接绑定宿主机指定调试目录，绕过 Docker 卷管理，便于运维人员实时访问：
- 在 compose 文件中添加：
- ./debug/${SERVICE_NAME}:/app/debug:rw - 应用在异常捕获（如 panic、HTTP 健康探针失败）时，自动生成
/app/debug/crash-$(date +%s).tar.gz，包含/proc/$$/stack、环境变量、最近 100 行日志缓冲 - 宿主机上执行
ls -t debug/agent-service/ | head -1即可定位最新现场包 - 该方式不依赖容器是否正常退出，只要进程还活着就能触发归档
结合 localtime 挂载确保时间戳可信
现场文件若含时间戳，必须与宿主机一致，否则多服务日志对齐困难。仅靠 TZ 环境变量不够稳定，需双重保障：
- 在 compose 文件中统一挂载：
- /etc/localtime:/etc/localtime:ro - 同时设置环境变量：
TZ: Asia/Shanghai（按实际时区调整） - 验证方式：进入容器执行
date && ls -l /app/debug/，确认两者时间显示一致 - 避免因 UTC 与本地时间偏差导致“现场发生在 2 秒前”却显示为“昨天”，干扰故障时间线重建
自动化现场归档脚本集成到 CI/CD 流水线
现场留存不能只靠人工触发。建议将归档逻辑下沉至基础镜像或启动脚本，并在流水线中注入归档开关：
- 构建镜像时，嵌入一个
/usr/local/bin/save-context脚本，支持--on-crash和--on-signal模式 - compose 中通过
command或entrypoint启用该脚本，例如：command: ["sh", "-c", "save-context --on-crash && exec myapp"] - K8s 或 Swarm 环境中可复用同一脚本，实现跨平台现场留存一致性
- 归档包默认压缩加密（如
gpg --symmetric），防止敏感配置泄露
