C#项目如何在DockerFile中添加第三方DLL并解决构建报错问题

错误核心原因 #

Docker构建时存在上下文目录限制：执行docker build命令时指定的目录为构建上下文根目录，Docker仅能访问该目录下的所有文件/子目录，你直接写宿主机D盘的绝对路径不在构建上下文范围内，因此无法定位到DLL文件。

解决步骤 #

1. 调整第三方DLL的存放位置：在你的解决方案根目录（也就是你执行docker build命令的目录）下新建libs文件夹，将PluginProject.dll复制到该文件夹内，确保DLL处于构建上下文范围内。
2. 修改Dockerfile中的COPY指令，将原来的绝对路径替换为相对上下文根目录的相对路径，同时删除原dotnet restore行末尾多余的反引号。

修改后完整Dockerfile #

FROM mcr.microsoft.com/dotnet/aspnet:5.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build
WORKDIR /src
# 替换为相对上下文的路径
COPY ["libs/PluginProject.dll", "MultiLayeredProject/"]
COPY ["MultiLayeredProject/MultiLayeredProject.csproj", "MultiLayeredProject/"]
COPY ["AppService/AppService.csproj", "AppService/"]
COPY ["Core/Core.csproj", "Core/"]
# 删掉了原行末尾多余的反引号
RUN dotnet restore "MultiLayeredProject/MultiLayeredProject.csproj"
COPY . .
WORKDIR "/src/MultiLayeredProject"
RUN dotnet build "MultiLayeredProject.csproj" -c Release -o /app/build

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

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

构建命令注意事项 #

如果你的Dockerfile放在WebApi项目的子目录下，需要显式指定构建上下文为解决方案根目录，示例命令如下：

docker build -t your-image-name -f ./MultiLayeredProject/Dockerfile .

末尾的.代表上下文为当前执行命令的目录（即解决方案根目录），不可省略。

额外校验点 #

• 检查你的.dockerignore文件是否排除了libs目录，如果有需要删除该规则
• 确保DLL的路径大小写和实际文件一致，避免Linux容器下大小写敏感导致的找不到文件问题

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