Visual Studio Docker Release模式构建失败求助

核心问题 #

Debug模式构建正常但Release模式Docker构建失败，本质原因是Dockerfile的构建顺序错误：在执行dotnet restore时，依赖的本地项目文件还未被复制到容器中，导致.NET将本地项目引用误认为NuGet包引用，去nuget.org查找不存在的Base.Application等包，最终restore失败。

Debug模式下Visual Studio会自动处理依赖项目的构建与文件复制，所以能绕过这个问题，但Release模式严格遵循Dockerfile步骤，就暴露了问题。

解决方案 #

1. 调整Dockerfile的复制与restore顺序

修改Dockerfile，先复制所有依赖项目的.csproj文件，再执行dotnet restore，确保restore时能识别本地项目引用：

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
USER app
WORKDIR /app
EXPOSE 8080
EXPOSE 8081

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
ARG BUILD_CONFIGURATION=Release
WORKDIR /src

# 先复制所有依赖项目的csproj到对应目录
COPY ["Auth.Api/Auth.Api.csproj", "Auth.Api/"]
COPY ["Auth.Shared/Auth.Shared.csproj", "Auth.Shared/"]
COPY ["Auth.Application/Auth.Application.csproj", "Auth.Application/"]
COPY ["Auth.Domain/Auth.Domain.csproj", "Auth.Domain/"]
COPY ["Auth.Infra/Auth.Infra.csproj", "Auth.Infra/"]
# 复制Base系列本地项目的csproj（根据实际项目结构调整）
COPY ["Base.Api/Base.Api.csproj", "Base.Api/"]
COPY ["Base.Application/Base.Application.csproj", "Base.Application/"]
COPY ["Base.Domain/Base.Domain.csproj", "Base.Domain/"]

# 还原Auth.Api的所有依赖（包括本地项目）
RUN dotnet restore "./Auth.Api/Auth.Api.csproj"

# 复制所有项目文件
COPY . .
WORKDIR "/src/Auth.Api"
RUN dotnet build "./Auth.Api.csproj" -c $BUILD_CONFIGURATION -o /app/build

FROM build AS publish
ARG BUILD_CONFIGURATION=Release
RUN dotnet publish "./Auth.Api.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false

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

2. 检查.dockerignore配置

确保.dockerignore没有排除依赖项目的目录，比如不要包含类似Auth.Shared/、Base.Application/这样的规则，仅排除编译输出目录即可：

**/bin/
**/obj/

3. 确认项目引用类型

右键Auth.Api项目 → 管理NuGet程序包 → 查看引用，确保Base.Application、Auth.Shared等是项目引用（而非NuGet包引用）。如果是包引用，移除后重新添加项目引用。

补充说明 #

• 这种调整既保证了Docker构建的缓存效率（先复制csproj再restore，后续代码修改不会触发重复restore），又解决了本地项目引用的识别问题。
• 若解决方案中有多个项目，需确保所有被引用的本地项目的.csproj都在restore前被复制到容器的对应路径中。

内容的提问来源于stack exchange，提问作者Stier Máté