Docker构建报错Can’t add file to tar，删除无关目录可解决，求原因

尝试使用Dockerfile构建Windows容器时持续报错，删除C:\src\bling\blingDemo\Models\SemanticDocument这个看似无关的目录后错误消失。根据Dockerfile内容，它本不应与该目录产生关联，但错误却指向此目录。

Dockerfile内容 #

# Use the latest Windows Server Core 2022 image.
FROM mcr.microsoft.com/windows/servercore:ltsc2022

# Copy build files into the container.
COPY SDWebServer/ Users/Administrator/Downloads/Models/SDWebServer/

# Install chocolatey.
RUN powershell -Command Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

# Install Python version 3.9
RUN choco install -y python3 --version 3.9

# Install requirements.txt
RUN pip install -r Users/Administrator/Downloads/Models/SDWebServer/requirements.txt

错误信息 #

(base) PS C:\src\bling\blingDemo\Models>
time="2023-12-08T17:40:03-08:00" level=error msg="Can't add file \\\\?\\C:\src\bling\blingDemo\Models\SemanticDocument\packages\System.Xml.XDocument.4.3.0\ref\wp80 to tar: archive/tar: missed writing 1128967 bytes"

文件结构 #

核心原因：Docker构建上下文机制 #

Docker构建容器时，会将执行docker build命令的当前目录（此处为C:\src\bling\blingDemo\Models）作为构建上下文，把该目录下所有文件和子目录打包成tar包发送给Docker daemon——哪怕你的COPY指令只用到其中一个子目录。

SemanticDocument属于构建上下文的一部分，因此会被纳入打包流程，报错的具体诱因包括：

• 该目录下的System.Xml.XDocument.4.3.0\ref\wp80文件损坏、不完整，或文件大小异常，导致Docker打包tar包时写入失败；
• 该文件/目录被其他进程占用，Docker无法读取完整内容；
• Windows环境下Docker处理特殊文件（如长路径、符号链接）时的兼容性问题。

解决方案 #

1. 用.dockerignore排除无关目录
   在C:\src\bling\blingDemo\Models目录下创建.dockerignore文件，写入：

SemanticDocument/

Docker构建时会自动跳过该目录，既避免打包无关文件，也能解决报错。

2. 检查修复问题文件
   若需保留SemanticDocument目录，可检查wp80文件完整性，尝试重新生成该文件，或关闭占用它的进程后再执行构建。

3. 调整构建上下文路径
   切换到SDWebServer目录执行构建，或用-f参数指定Dockerfile路径，同时将上下文设为SDWebServer：

docker build -f ..\Dockerfile .

此时构建上下文仅包含SDWebServer内容，不会涉及SemanticDocument目录。

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