Asp.NetCore项目通过Dockerfile构建Docker镜像时项目文件未找到的解决方法

问题背景 #

你的ASP.NET Core项目结构分为Account和Common两个根目录，每个目录下包含多个子项目（API、Domain、Persistence、Service等）。使用自动生成的Dockerfile构建镜像时，出现一个或多个项目文件未找到的错误。

自动生成的Dockerfile如下：

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

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
COPY ["Account/Portal.Account.API/Portal.Account.API.csproj", "Account/Portal.Account.API/"]
COPY ["Common/Portal.Common.Persistence/Portal.Common.Persistence.csproj", "Common/Portal.Common.Persistence/"]
COPY ["Common/Portal.Common.Domain/Portal.Common.Domain.csproj", "Common/Portal.Common.Domain/"]
COPY ["Common/Portal.Common.Service/Portal.Common.Service.csproj", "Common/Portal.Common.Service/"]
COPY ["Account/Portal.Account.Domain/Portal.Account.Domain.csproj", "Account/Portal.Account.Domain/"]
COPY ["Account/Portal.Account.Persistence/Portal.Account.Persistence.csproj", "Account/Portal.Account.Persistence/"]
COPY ["Account/Portal.Account.Service/Portal.Account.Service.csproj", "Account/Portal.Account.Service/"]
RUN dotnet restore "Account/Portal.Account.API/Portal.Account.API.csproj"
COPY . .
WORKDIR "/src/Account/Portal.Account.API"
RUN dotnet build "Portal.Account.API.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "Portal.Account.API.csproj" -c Release -o /app/publish /p:UseAppHost=false

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

错误原因 #

核心问题是构建上下文路径不匹配：

• 执行docker build时，若未在解决方案根目录执行，Docker无法找到COPY命令中指定的项目文件路径；
• 自动生成的COPY命令路径可能与实际项目的目录结构存在细微差异，导致restore阶段无法定位依赖项目。

解决方案 #

1. 确保在解决方案根目录执行构建命令 #

打开终端，切换到你的解决方案根目录（即包含Account和Common文件夹的目录），执行构建命令：

docker build -t portal-account-api .

这里的.表示将当前目录作为Docker构建上下文，确保Docker能找到所有项目文件。

2. 优化Dockerfile的COPY步骤（更可靠） #

可以简化csproj的复制逻辑，使用通配符减少手动路径编写的错误，同时先复制解决方案文件（如果有）确保restore能正确解析所有依赖：

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

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
# 复制解决方案文件（替换为你的实际解决方案文件名）
COPY ["Portal.sln", "."]
# 用通配符批量复制所有项目的csproj到对应目录
COPY ["Account/*/*.csproj", "Account/"]
COPY ["Common/*/*.csproj", "Common/"]
# 恢复API项目的依赖
RUN dotnet restore "Account/Portal.Account.API/Portal.Account.API.csproj"
# 复制所有源代码文件
COPY . .
WORKDIR "/src/Account/Portal.Account.API"
RUN dotnet build "Portal.Account.API.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "Portal.Account.API.csproj" -c Release -o /app/publish /p:UseAppHost=false

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

3. 验证项目引用路径 #

检查每个项目的.csproj文件中，ProjectReference的路径是否正确。例如Portal.Account.API.csproj中引用服务项目的路径应为：

<ProjectReference Include="..\Portal.Account.Service\Portal.Account.Service.csproj" />

确保路径与Docker容器内的目录结构一致，避免restore时找不到依赖项目。

验证 #

修改完成后，再次在解决方案根目录执行构建命令，即可正常完成Docker镜像的构建。

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