Mac环境下Dockerfile构建镜像报错open .Trash无权限如何解决

问题根因 #

你遇到的报错和COPY指令本身无关，是Docker构建上下文的配置错误导致的：

• 执行docker build时，命令中指定的.代表将当前执行命令的工作目录作为构建上下文，Docker会默认遍历该目录下的所有文件/文件夹上传给Docker daemon
• 如果你执行命令的路径是Mac的用户根目录（~/），目录下的.Trash是系统级回收站目录，默认开启SIP（系统完整性保护）限制，无权限读取，因此触发报错
• 即使加sudo也无法绕过SIP的权限限制，所以sudo操作无效

排查&解决步骤 #

方案1：修改构建上下文路径为Dockerfile所在目录 #

直接将构建上下文指向你存放Dockerfile和test.py的目录，不需要额外指定-f参数，执行命令改为：

cd abs/path/to
docker build --no-cache . -t intro_to_docker

或者不切换目录，直接指定上下文路径：

docker build --no-cache abs/path/to -t intro_to_docker

此时Docker只会扫描abs/path/to下的两个文件，不会触及根目录的.Trash文件夹，不会触发权限报错。

方案2：添加.dockerignore文件排除不需要的文件 #

如果确实需要使用当前目录作为构建上下文，可以在当前执行命令的目录下新建.dockerignore文件，添加以下内容：

.Trash
# 还可以添加其他不需要传入上下文的文件，减少构建包体积
.DS_Store
*.log
__pycache__

Docker在打包上下文时会自动忽略这些文件，不会尝试读取.Trash目录。

额外校验项 #

解决权限报错后，建议修改Dockerfile避免后续依赖报错：你的test.py中导入了pandas、numpy库，但当前Dockerfile中没有安装这两个依赖，构建到RUN python3 test.py步骤时会报模块不存在错误，可修改安装语句为：

RUN apt-get update && apt-get install -y python3 python3-pip && pip install pandas numpy

同时注意Dockerfile文件名大小写，官方默认识别Dockerfile（首字母大写，其余小写），如果你的文件命名是DockerFile（末尾F大写），才需要额外加-f参数指定文件名。

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