.NET Framework 4.7.2 API Docker构建遇CS0246：无法找到Newtonsoft

问题背景 #

将基于.NET Framework 4.7.2的API项目Docker化，本地运行无异常，但Docker构建时msbuild步骤报错CS0246，提示找不到Newtonsoft命名空间。执行nuget restore后，容器内的packages文件夹已存在所有还原的包，但构建仍失败。

Dockerfile内容 #

# start with a base image with all the necessary tooling to compile our app
FROM mcr.microsoft.com/dotnet/framework/sdk:4.8 AS build

# set the working directory inside compilation container to c:\app
WORKDIR /app
COPY . .

# setting up RSA key
WORKDIR C:/Windows/Microsoft.NET/Framework64/v4.0.30319
RUN aspnet_regiis -pi <keys> "/app/keys.xml"
WORKDIR /app
ARG npm_token 
ENV npm=${npm_token}

# restore nuget packages
RUN nuget restore

# use msbuild to publish project to c:\publish
RUN msbuild .\<proj>.sln /p:DeployOnBuild=true /property:Configuration=Release /p:PublishProfile=FolderProfile /p:PublishUrl="c:\publish"

FROM mcr.microsoft.com/windows/servercore/iis
RUN powershell Install-WindowsFeature NET-Framework-45-ASPNET ; \  
Install-WindowsFeature Web-Asp-Net45 ; Install-WindowsFeature Web-Windows-Aut

WORKDIR /inetpub/wwwroot
# copy files from bin/publish in our sdk container into c:\inetpub\wwwroot
COPY --from=build /publish ./

错误日志 #

"C:\app\<proj>.sln" (default target) (1) ->
"C:\app\<proj>\<proj>.csproj" (default target) (20) ->
"C:\app\<proj>.Integration.Stratosphere\<proj>.Integration.Sphere.csproj"(defaulttarget)(22:2) ->
(CoreCompile target) ->
  C:\app\<proj>.Integration.Sphere\Parser.cs(2,7): error CS0246: The type or namespace name "Newtonsoft" could not be found (are you missing a using directive or an assembly reference?) [C:\app\<proj>.Integration.Sphere\CoreconWebApi.Integration.Stratosphere.csproj]
  C:\app\<proj>.Integration.Sphere\StratoService.cs(10,7):error CS0246: The type or namespace name "Newtonsoft" could not be found (are you missing a using directive or an assembly reference?) C:\app\<proj>.Integration.Sphere\CoreconWebApi.Integration.Sphere.csproj

    200 Warning(s)
    2 Error(s)

解决方案 #

1. 强制指定NuGet包路径给MSBuild #

容器中NuGet还原的包可能不在MSBuild默认搜索路径内，修改msbuild命令，显式指定packages路径：

RUN msbuild .\<proj>.sln /p:DeployOnBuild=true /property:Configuration=Release /p:PublishProfile=FolderProfile /p:PublishUrl="c:\publish" /p:PackagesPath=.\packages

2. 检查项目文件的引用配置 #

打开出错的<proj>.Integration.Sphere.csproj，确认Newtonsoft.Json的引用HintPath是否指向容器内正确的相对路径：

<Reference Include="Newtonsoft.Json, Version=13.0.0.0, Culture=neutral, PublicKeyToken=30ad4fe6b2a6aeed, processorArchitecture=MSIL">
  <HintPath>..\packages\Newtonsoft.Json.13.0.3\lib\net45\Newtonsoft.Json.dll</HintPath>
</Reference>

确保相对路径在容器的/app目录结构下有效，和本地项目结构一致。

3. 添加.dockerignore并清理本地编译产物 #

创建.dockerignore文件排除本地编译缓存和packages目录，避免干扰容器内构建：

bin/
obj/
packages/

本地执行dotnet clean删除bin、obj文件夹后再重新构建镜像。

4. 锁定SDK镜像版本 #

使用更具体的.NET Framework SDK镜像版本，避免兼容性问题：

FROM mcr.microsoft.com/dotnet/framework/sdk:4.8.1-windowsservercore-ltsc2019 AS build

5. 指定NuGet源进行还原 #

确保容器内使用正确的NuGet源，避免包还原不完整：

RUN nuget restore -Source https://api.nuget.org/v3/index.json

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