基于Dockerfile构建Docker镜像时出现CS0246等编译错误

我有一个包含两个Web服务的解决方案，所有项目目标框架均为net6.0，本地构建完全正常，但通过Dockerfile构建镜像时，dotnet build阶段抛出大量CS0246（类型或命名空间找不到）错误。

我的Dockerfile内容 #

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS env
WORKDIR /app

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src

COPY . .
RUN dotnet restore

COPY . .
RUN dotnet build -c Debug -o /app/build --no-restore

FROM build AS publish
RUN dotnet publish "My.Api/My.Api.csproj" -c Debug -o /app/publish --no-build --no-restore

FROM env AS final
WORKDIR /app
COPY --from=build /app/publish ./
EXPOSE 5000
ENV ASPNETCORE_URLS=https://+:5000
ENV ASPNETCORE_ENVIRONMENT=Development
ENTRYPOINT ["dotnet", "My.Api.dll"]

执行的构建命令 #

docker build . -t my.api:1.0.0 -t my.api:lastest -f ./My.Api/Dockerfile --no-cache

错误输出片段 #

[+] Building 45.9s (14/15)
[internal] load build definition from Dockerfile
transferring dockerfile: 618B
[internal] load .dockerignore
transferring context: 35B
[internal] load metadata for mcr.microsoft.com/dotnet/aspnet:6.0
[internal] load metadata for mcr.microsoft.com/dotnet/sdk:6.0
[build 1/6] FROM mcr.microsoft.com/dotnet/sdk:6.0
[env 1/2] FROM mcr.microsoft.com/dotnet/aspnet:6.0
[internal] load build context
transferring context: 11.35kB
CACHED [build 2/6] WORKDIR /src
CACHED [env 2/2] WORKDIR /app
CACHED [final 1/2] WORKDIR /app
[build 3/6] COPY . .
[build 4/6] RUN dotnet restore
[build 5/6] COPY . .
ERROR [build 6/6] RUN dotnet build -c Debug -o /app/build --no-restore
------
 > [build 6/6] RUN dotnet build -c Debug -o /app/build --no-restore:
#14 0.700 MSBuild version 17.3.2+561848881 for .NET
#14 4.307 /src/Localization/LocalizationAttribute.cs(6,47): error CS0246: The type or namespace name 'Attribute' could not be found (are you missing a using directive or an assembly reference?) [/src/Localization/Localization.csproj]
#14 4.307 /src/Localization/LocalizationAttribute.cs(5,2): error CS0246: The type or namespace name 'AttributeUsageAttribute' could not be found (are you missing a using directive or an assembly reference?) [/src/Localization/Localization.csproj]
#14 4.307 /src/Localization/LocalizationAttribute.cs(5,2): error CS0246: The type or namespace name 'AttributeUsage' could not be found (are you missing a using directive or an assembly reference?) [/src/Localization/Localization.csproj]
#14 4.307 /src/Localization/LocalizationAttribute.cs(5,17): error CS0103: The name 'AttributeTargets' does not exist in the current context [/src/Localization/Localization.csproj]
#14 4.307 /src/Localization/LocalizationAttribute.cs(8,22): error CS0246: The type or namespace name 'Type' could not be found (are you missing a using directive or an assembly reference?) [/src/Localization/Localization.csproj]
#14 4.307 /src/Localization/LocalizationAttribute.cs(10,57): error CS0246: The type or namespace name 'Type' could not be found (are you missing a using directive or an assembly reference?) [/src/Localization/Localization.csproj]
#14 4.307 /src/Localization/LocalizationAttribute.cs(18,13): warning CS8632: The annotation for nullable reference types should only be used in code within a '#nullable' annotations context. [/src/Localization/Localization.csproj]
#14 4.315 /src/Common/Extensions/CollectionExtensions.cs(5,40): error CS0246: The type or namespace name 'IEnumerable<>' could not be found (are you missing a using directive or an assembly reference?) [/src/Common/Common.csproj]
#14 4.315 /src/Common/Extensions/CollectionExtensions.cs(12,40): error CS0246: The type or namespace name 'ICollection<>' could not be found (are you missing a using directive or an assembly reference?) [/src/Common/Common.csproj]
#14 4.315 /src/Common/Extensions/CollectionExtensions.cs(14,43): error CS0246: The type or namespace name 'IEnumerable<>' could not be found (are you missing a using directive or an assembly reference?) [/src/Common/Common.csproj]
#14 4.315 /src/Common/Extensions/StringExtensions.cs(7,70): warning CS8632: The annotation for nullable reference types should only be used in code within a '#nullable' annotations context. [/src/Common/Common.csproj]
#14 5.176
#14 5.176 Build FAILED.
#14 5.17

已尝试的方法 #

• 将Dockerfile移至解决方案根目录
• 带/不带--no-cache参数执行构建命令
• 仅执行COPY步骤后进入容器检查，确认所有文件都已正确复制

解决方案 #

1. 修复Dockerfile中的冗余COPY步骤 #

原Dockerfile中连续两次执行COPY . .，会覆盖dotnet restore生成的obj目录，导致构建时找不到已还原的依赖。修改后的Dockerfile如下：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS env
WORKDIR /app

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src

# 先复制解决方案和项目文件，利用Docker缓存优化构建速度
COPY *.sln .
COPY My.Api/My.Api.csproj My.Api/
COPY Localization/Localization.csproj Localization/
COPY Common/Common.csproj Common/

# 还原依赖
RUN dotnet restore

# 复制所有源代码
COPY . .

# 构建项目
RUN dotnet build -c Debug -o /app/build --no-restore

FROM build AS publish
RUN dotnet publish "My.Api/My.Api.csproj" -c Debug -o /app/publish --no-build --no-restore

FROM env AS final
WORKDIR /app
COPY --from=publish /app/publish ./
EXPOSE 5000
ENV ASPNETCORE_URLS=https://+:5000
ENV ASPNETCORE_ENVIRONMENT=Development
ENTRYPOINT ["dotnet", "My.Api.dll"]

2. 检查.dockerignore文件 #

确保.dockerignore没有误排除必要文件（如.sln、.csproj或obj目录），否则dotnet restore和build会无法找到依赖或项目配置。

3. 指定解决方案文件构建 #

如果构建时未自动识别解决方案，可在dotnet build命令中明确指定sln文件：

RUN dotnet build YourSolutionName.sln -c Debug -o /app/build --no-restore

4. 确认项目引用正确性 #

检查各项目的.csproj文件，确保Localization和Common项目被My.Api正确引用，且引用路径无错误。

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