Docker commit无法保存添加到镜像的文件，该如何排查？

• 检查目标目录是否挂载了卷
  执行docker inspect <容器ID>查看Mounts字段，如果/srv被配置为卷挂载，那么docker commit不会保存卷内的内容——卷数据独立于容器的可写层。这种情况可以换一个非卷目录复制文件，或者先把卷内文件拷贝到容器的非卷路径（比如/tmp/srv-backup）再执行commit。

• 验证目录的写权限与镜像层写入限制
  部分镜像会将/srv设为只读挂载，或容器运行用户无写入权限。虽然docker cp能将文件传入容器（exec可见），但commit时可能因权限问题无法将文件写入镜像层。可以先尝试将文件复制到/tmp这类通用目录，再commit验证是否能持久化，以此排除权限干扰。

• 确认commit命令的有效性
  确保commit的容器ID正确，且指定了清晰的镜像标签（比如docker commit <容器ID> my-custom-image:v1）。不要通过原容器验证结果，直接启动新镜像查看内容：docker run --rm my-custom-image:v1 ls /srv，避免混淆原容器的临时状态。

• 查看镜像层的变更记录
  执行docker history <新镜像ID>，检查commit生成的镜像层是否有大小变化。如果对应层大小为0，说明文件未被写入镜像，可进一步排查容器内文件的实际存储位置。

• 排查启动脚本的覆盖逻辑
  部分镜像的ENTRYPOINT或CMD会在容器启动时覆盖/srv目录（比如从默认配置目录同步数据）。你在原容器exec看到的是当前运行状态，但新镜像启动时脚本会重置目录内容。可以直接跳过启动脚本验证：docker run --rm my-custom-image:v1 cat /srv/你的文件名，或用bash直接查看：docker run --rm my-custom-image:v1 bash -c "ls -l /srv"。

• 改用Dockerfile构建替代commit
  即使没有原镜像的Dockerfile，也可以基于它编写极简构建文件：

  FROM 原镜像名称:原标签
  COPY 本地待添加文件 /srv/
  

  执行docker build -t my-custom-image:v1 .构建，这种方式更可靠，还能直接看到构建过程中的错误提示（比如目录不存在、权限不足等）。

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