Docker Commit/Push未包含容器内复制文件的问题排查求助

这问题我之前帮同行排查过好几次，大概率是踩了Docker镜像构建的几个常见坑，咱们一步步来定位解决：

1. 先排查是不是卷挂载导致commit没捕获内容 #

如果你本地运行容器时用了-v参数把本地目录挂载到容器的/app，那卷里的内容不会被包含到commit生成的镜像里——因为Docker的卷是独立于容器可写层的外部存储，commit只能保存容器自身的文件系统层。

解决办法：

• 先停止当前运行的容器：docker stop <你的容器ID>
• 重新启动一个不带卷挂载的容器，把代码手动复制到容器内部的/app：

  docker run -d --name temp-container <原始镜像>
  docker cp ./本地代码目录 temp-container:/app
  

• 再对这个temp-container执行commit操作，之后验证本地镜像的/app是否有内容。

2. 检查commit操作是否正确捕获了容器层 #

有时候容器运行时的临时状态可能导致commit没正确保存/app的内容，你可以先验证本地commit后的镜像：

• 运行本地commit的镜像，查看/app目录：docker run -it <你的镜像名:标签> ls /app
• 如果本地镜像里/app也是空的，那重新执行commit时加上参数确保完整捕获：

  docker commit -a "你的名字" -m "添加.NET Core应用代码" <容器ID> <镜像名:标签>
  

• 再次验证本地镜像，确认/app有内容后再push。

3. 排查镜像仓库的缓存或拉取问题 #

如果本地commit后的镜像没问题，但拉取后为空，可能是缓存搞的鬼：

• 拉取时不要用latest标签（这个标签极易触发缓存），改用明确的版本号，比如docker pull <你的镜像名>:v1
• 先删除本地旧镜像：docker rmi <你的镜像名>:v1，再重新拉取
• 检查镜像仓库里的镜像大小，如果和本地commit后的镜像大小差很多，说明push过程可能有异常，重新执行docker push。

4. 更靠谱的替代方案：放弃docker commit，用Dockerfile构建 #

其实docker commit只是临时应急的方式，生产环境绝对不推荐——它的构建过程不可重复，很容易出现这种奇怪的层丢失问题。正确的做法是用Dockerfile来构建镜像，把代码固化到镜像层里，比如针对.NET Core的示例Dockerfile：

# 基础运行镜像
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80

# 构建镜像
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["YourApp.csproj", "."]
RUN dotnet restore "./YourApp.csproj"
# 复制所有代码到构建环境
COPY . .
WORKDIR "/src/."
RUN dotnet build "YourApp.csproj" -c Release -o /app/build

# 发布应用
FROM build AS publish
RUN dotnet publish "YourApp.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 生成最终运行镜像
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "YourApp.dll"]

用这个Dockerfile执行docker build -t <镜像名:标签> .构建的镜像，不管push到哪个仓库，拉取后/app目录的内容都不会丢失，而且构建过程完全可重复。

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