K8s Pod挂载文件至主机失败，出现CrashLoopBackOff故障排查

核心问题分析 #

1. 挂载目标完全不匹配
   你期望共享Pod内的/opt/e2/router.txt到主机目录，但当前Deployment配置中，hostvol仅挂载了/opt/e2/leak.out，而router.txt实际是通过ConfigMap（local-router-file）挂载的，根本没用到HostPath卷——这就是主机/home/ubuntu/pod-share/下找不到目标文件的直接原因。

2. ConfigMap挂载的局限性
   router.txt通过ConfigMap挂载到Pod存在两个关键问题：

   • Pod内对该文件的修改不会同步回ConfigMap，更无法直接同步到主机
   • 如果容器原生依赖/opt/e2/router.txt的特定内容或权限，ConfigMap挂载可能覆盖原有文件，导致容器启动逻辑失败（这大概率是CrashLoopBackOff的根源）

3. 挂载错误未显示的原因
   kubectl describe pod仅报告挂载阶段的系统错误，容器启动失败可能是进程自身逻辑问题（比如找不到预期的文件内容、权限不匹配），必须查看容器日志才能定位具体错误。

解决步骤 #

1. 修正HostPath挂载配置 #

修改Deployment，将/opt/e2/router.txt通过hostvol挂载到主机目录：

volumeMounts:
# 移除原ConfigMap挂载router.txt的配置
# - mountPath: /opt/e2/router.txt
#   name: local-router-file
#   subPath: router.txt
- mountPath: /opt/e2/router.txt
  name: hostvol
  subPath: router.txt
# 保留其他挂载配置...
volumes:
# 保留hostvol配置不变
- hostPath:
    path: /home/ubuntu/pod-share/
    type: ""
  name: hostvol
# 若不需要ConfigMap提供其他文件，可移除local-router-file配置

2. 排查容器启动失败的具体原因 #

执行以下命令获取容器日志，明确CrashLoopBackOff的触发点：

kubectl logs deployment-ricplt-e2term-alpha-54c8f5f7f4-f8s8p -n ricplt
# 查看上一次启动的错误日志
kubectl logs deployment-ricplt-e2term-alpha-54c8f5f7f4-f8s8p -n ricplt --previous

3. 修复主机目录权限 #

确保主机/home/ubuntu/pod-share/目录权限允许Kubelet读写：

sudo chmod 755 /home/ubuntu/pod-share/
sudo chown ubuntu:ubuntu /home/ubuntu/pod-share/

内容的提问来源于stack exchange，提问作者ravi