Docker构建ASP.NET 6项目时无法解析本地类库引用求助

问题根源 #

1. MSB3245警告：Docker构建时仅复制了Web项目代码，本地类库的代码未同步到容器中；同时项目直接引用了本地Debug目录下的DLL，容器内不存在该路径的文件，导致程序集查找失败。
2. CS5001错误：并非真的缺少Main入口点，而是类库引用失败引发编译中断，间接导致该错误，解决类库问题后此错误会自动消失。

修复步骤 #

1. 替换DLL引用为项目引用 #

打开ProjectName.csproj，删除原有的直接DLL引用节点，改为引用类库的项目文件，让dotnet build自动处理类库的构建依赖：

<Project Sdk="Microsoft.NET.Sdk.Web">

    <PropertyGroup>
        <TargetFramework>net6.0</TargetFramework>
        <Nullable>enable</Nullable>
        <ImplicitUsings>enable</ImplicitUsings>
        <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
    </PropertyGroup>

    <ItemGroup>
        <!-- 保留原有NuGet包引用 -->
        ....
    </ItemGroup>

    <ItemGroup>
      <!-- 替换为项目引用，路径根据实际目录结构调整 -->
      <ProjectReference Include="..\..\PackageName\PackageName\PackageName.csproj" />
    </ItemGroup>

</Project>

2. 调整Dockerfile确保类库参与构建 #

修改Dockerfile，先复制所有项目的.csproj完成依赖还原，再同步全部源代码，保证类库代码能被容器构建：

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

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
# 先复制Web项目和类库项目的csproj，用于依赖还原
COPY ["ProjectName/ProjectName.csproj", "ProjectName/"]
COPY ["PackageName/PackageName/PackageName.csproj", "PackageName/PackageName/"]
# 还原所有项目的依赖（包含类库）
RUN dotnet restore "ProjectName/ProjectName.csproj"
# 复制全部源代码到容器
COPY . .
WORKDIR "/src/ProjectName"
# 使用Release配置构建（若有自定义Publish配置可替换）
RUN dotnet build "ProjectName.csproj" -c Release -o /app/build

# 修正阶段命名，避免引用错误
FROM build AS publish
RUN dotnet publish "ProjectName.csproj" -c Release -o /app/publish

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

3. 验证构建 #

重新执行docker build .，容器会自动构建类库项目并完成Web项目的编译，两个问题都会被解决。

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