Docker Build时出现‘无法复制文件...访问被拒绝’错误的解决方法

问题现象 #

构建Docker镜像时出现以下权限拒绝错误：

#15 3.551 /usr/share/dotnet/sdk/6.0.302/Microsoft.Common.CurrentVersion.targets(5097,5): error MSB3021: Unable to copy file "/src/obj/Release/net6.0/apphost" to "bin/Release/net6.0/WebAPI". Access to the path '/src/bin/Release/net6.0/WebAPI' is denied. [/src/WebAPI.csproj]

解决方案 #

1. 清理本地构建缓存后重新构建 #

本地项目的bin、obj目录可能带有系统权限标记，被复制到容器后导致权限冲突。先清理本地文件：

dotnet clean

然后执行Docker构建（强制禁用缓存确保规则生效）：

docker build --no-cache -t webapi-image .

2. 确认.dockerignore规则生效 #

检查.dockerignore是否与Dockerfile在同一目录，并且规则正确排除了bin、obj目录。如果之前有构建缓存，--no-cache参数会强制Docker重新读取.dockerignore规则。

3. 调整Dockerfile的工作目录结构 #

原Dockerfile中COPY . .会把所有文件复制到/src根目录，容易引发权限冲突。修改为将文件复制到项目子目录并切换到该目录构建：

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 ["WebAPI.csproj", "WebAPI/"]
RUN dotnet restore "WebAPI/WebAPI.csproj"
COPY . ./WebAPI/
WORKDIR /src/WebAPI

FROM build AS publish
RUN dotnet publish "WebAPI.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebAPI.dll"]

4. 使用非root用户执行构建（Linux环境适用） #

避免以root用户进行构建操作，减少权限冲突概率：

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
# 创建非root用户
RUN useradd -m appuser
WORKDIR /src
COPY ["WebAPI.csproj", "WebAPI/"]
RUN dotnet restore "WebAPI/WebAPI.csproj"
COPY . .
# 授予用户目录权限
RUN chown -R appuser:appuser /src
# 切换到非root用户
USER appuser

FROM build AS publish
RUN dotnet publish "WebAPI.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebAPI.dll"]

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