构建含.NET 6与.NET Framework 4.8的C# Docker镜像及单元测试问题求助

一、解决.NET Framework 4.8单元测试构建错误 #

1. MSB3644错误处理 #

该错误源于Docker镜像缺少.NET Framework 4.8的引用程序集，不要使用普通.NET SDK镜像，改用包含完整Windows SDK的镜像：

# .NET Framework 4.8构建测试的基础镜像
FROM mcr.microsoft.com/dotnet/framework/sdk:4.8-windowsservercore-ltsc2019 AS build-48

若尝试用Linux镜像运行.NET Framework测试，需依赖Mono，但稳定性远不如Windows镜像，优先推荐Windows基础镜像方案。

2. MSBuild 1009错误处理 #

针对项目文件不存在的提示，检查以下几点：

• 确认COPY命令路径与本地项目结构完全匹配，例如测试项目在./Tests/Net48Tests，需写：

  COPY ./Tests/Net48Tests ./Tests/Net48Tests
  

• 执行msbuild时指定完整项目文件路径，避免仅写目标名称：

  RUN msbuild ./Tests/Net48Tests/Net48Tests.csproj /t:Test /p:Configuration=Release
  

• 检查.dockerignore是否误排除了测试项目文件。

二、Docker构建流程优化建议 #

1. 按框架拆分阶段的正确性与缓存优化 #

按框架拆分构建阶段是正确的，还需进一步细化分层缓存：

# .NET 6构建测试阶段
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build-6
WORKDIR /src
# 先复制项目文件，利用缓存跳过重复还原
COPY ./src/Net6Project/Net6Project.csproj ./src/Net6Project/
COPY ./Tests/Net6Tests/Net6Tests.csproj ./Tests/Net6Tests/
RUN dotnet restore ./src/Net6Project/Net6Project.csproj
RUN dotnet restore ./Tests/Net6Tests/Net6Tests.csproj

# 复制所有代码，构建并测试
COPY ./src/Net6Project ./src/Net6Project
COPY ./Tests/Net6Tests ./Tests/Net6Tests
RUN dotnet build ./src/Net6Project/Net6Project.csproj -c Release --no-restore
RUN dotnet test ./Tests/Net6Tests/Net6Tests.csproj -c Release --no-restore --no-build

# .NET Framework 4.8构建测试阶段
FROM mcr.microsoft.com/dotnet/framework/sdk:4.8-windowsservercore-ltsc2019 AS build-48
WORKDIR /src
# 先复制项目文件还原NuGet包
COPY ./src/Net48Project/Net48Project.csproj ./src/Net48Project/
COPY ./Tests/Net48Tests/Net48Tests.csproj ./Tests/Net48Tests/
RUN nuget restore ./src/Net48Project/Net48Project.csproj
RUN nuget restore ./Tests/Net48Tests/Net48Tests.csproj

# 复制代码构建并测试
COPY ./src/Net48Project ./src/Net48Project
COPY ./Tests/Net48Tests ./Tests/Net48Tests
RUN msbuild ./src/Net48Project/Net48Project.csproj /p:Configuration=Release /t:Build /p:NoRestore=true
RUN msbuild ./Tests/Net48Tests/Net48Tests.csproj /p:Configuration=Release /t:Test /p:NoRestore=true

# .NET 6发布镜像
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS publish-6
WORKDIR /app
COPY --from=build-6 /src/Net6Project/bin/Release/net6.0/publish ./

# .NET Framework 4.8发布镜像
FROM mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2019 AS publish-48
WORKDIR /inetpub/wwwroot
COPY --from=build-48 /src/Net48Project/bin/Release ./

将依赖还原与代码复制/构建拆分，依赖未变更时Docker会直接复用缓存，大幅缩短构建时间。

2. 其他低效点改进 #

• 配置.dockerignore排除bin/、obj/、.git/等无关文件，减少构建上下文传输体积。
• 测试阶段不保留冗余构建产物，仅将测试通过的发布文件传递到最终镜像，缩小镜像体积。
• 若有多个.NET 6组件，可通过解决方案文件批量还原依赖：

  RUN dotnet restore ./src/Net6Solution.sln
  

• 启用Docker BuildKit加速构建，启动构建时添加环境变量DOCKER_BUILDKIT=1，支持并行构建与缓存优化。

3. CI流程联动优化 #

• 将测试与镜像推送拆分为独立CI任务，仅当两个框架的测试全部通过后，才触发镜像推送步骤。
• 给镜像打标签时使用commit哈希或版本号，避免覆盖同一标签的镜像，便于后续回滚。

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