Docker构建ASP.NET Core 6应用时误建未还原测试项目问题

方案一：仅构建主项目（推荐，减少镜像体积和构建时间） #

问题原因 #

执行COPY . .时，测试项目的文件会被复制到镜像中；若解决方案文件存在，dotnet可能默认尝试构建整个解决方案，但测试项目的NuGet依赖未被还原，最终导致构建报错。

解决步骤 #

1. 添加.dockerignore排除测试项目
   在项目根目录创建.dockerignore文件，写入以下规则，避免复制测试项目的相关文件：

**/*Test*.csproj
**/Tests/
**/*.Tests/

2. 修改Dockerfile的build阶段
   仅复制主项目和依赖类库的csproj，构建时明确指定主项目并添加--no-restore参数（避免重复执行还原操作）：

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

FROM mcr.microsoft.com/dotnet/sdk:6.0-alpine AS build
WORKDIR /src
# 仅复制主项目和依赖类库的csproj
COPY ["MyProject.API/MyProject.API/MyProject.API.csproj", "MyProject.API/"]
COPY ["MyProject.API/MyProject.API.Persistence/MyProject.API.Persistence.csproj", "MyProject.API.Persistence/"]
COPY ["MyProject.API/MyProject.API.Domain/MyProject.API.Domain.csproj", "MyProject.API.Domain/"]
COPY ["MyProject.API/MyProject.Social/MyProject.Social.csproj", "MyProject.Social/"]
RUN dotnet restore "MyProject.API/MyProject.API.csproj"
# 复制剩余文件（已排除测试项目）
COPY . .
WORKDIR "/src/MyProject.API"
# 明确构建主项目，禁用自动还原
RUN dotnet build "MyProject.API.csproj" -c Release -o /app/build --no-restore

FROM build AS publish
RUN dotnet publish "MyProject.API.csproj" -c Release -o /app/publish --runtime alpine-x64 --no-self-contained

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
#COPY postgres.crt .
#COPY do-redis.crt .
ENTRYPOINT ["dotnet", "MyProject.API.dll"]

方案二：还原所有项目依赖（需构建测试项目时使用） #

解决步骤 #

如果需要在镜像中构建并运行测试，需复制所有项目（包括测试项目）的csproj，通过还原整个解决方案来处理所有依赖：

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

FROM mcr.microsoft.com/dotnet/sdk:6.0-alpine AS build
WORKDIR /src
# 复制所有项目的csproj（包括测试项目）
COPY ["MyProject.API/MyProject.API/MyProject.API.csproj", "MyProject.API/"]
COPY ["MyProject.API/MyProject.API.Persistence/MyProject.API.Persistence.csproj", "MyProject.API.Persistence/"]
COPY ["MyProject.API/MyProject.API.Domain/MyProject.API.Domain.csproj", "MyProject.API.Domain/"]
COPY ["MyProject.API/MyProject.Social/MyProject.Social.csproj", "MyProject.Social/"]
# 替换为你的测试项目实际路径
COPY ["MyProject.API/MyProject.API.Tests/MyProject.API.Tests.csproj", "MyProject.API.Tests/"]
COPY ["MyProject.API/MyProject.Social.Tests/MyProject.Social.Tests.csproj", "MyProject.Social.Tests/"]
# 还原整个解决方案的所有依赖
RUN dotnet restore "MyProject.API.sln"
COPY . .
WORKDIR "/src/MyProject.API"
# 构建主项目（如需构建整个解决方案，替换为"MyProject.API.sln"）
RUN dotnet build "MyProject.API.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "MyProject.API.csproj" -c Release -o /app/publish --runtime alpine-x64 --no-self-contained

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
#COPY postgres.crt .
#COPY do-redis.crt .
ENTRYPOINT ["dotnet", "MyProject.API.dll"]

说明 #

之前单独还原测试项目失败，是因为测试项目既依赖主项目类库，又需要单独还原自身的NuGet包（如Xunit）。通过还原整个解决方案，可一次性处理所有项目的依赖关系。

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