使用Docker构建.NET Framework 4.8 WPF应用遇MSTSCLib引用错误求助

问题详情 #

我是Docker新手，正在尝试用Docker构建基于.NET Framework 4.8的WPF应用。

Dockerfile内容 #

FROM mcr.microsoft.com/dotnet/framework/sdk:4.8 as base
WORKDIR /
COPY . ./
RUN nuget restore
RUN msbuild /t:Restore ./ProjectName.csproj
RUN msbuild /p:Configuration=Release ./ProjectName.csproj

构建命令 #

docker build -f Dockerfile . --no-cache

报错信息 #

前面步骤均正常，执行最后一行msbuild命令时出现：

error CS0246: The type or namespace name 'MSTSCLib' could not be found
(are you missing a using directive or an assembly reference?)

已尝试修改项目中MSTSCLib引用的“Copy Local”和“Embed Interop Types”属性，但问题未解决。

解决办法 #

MSTSCLib是Windows系统自带的远程桌面控件对应的互操作程序集，Docker容器内的.NET Framework SDK镜像默认没有包含该组件的COM环境，导致构建时无法找到引用。可以通过以下方案解决：

• 方案1：手动复制互操作程序集到容器

  1. 在本地项目的obj\Release（或Debug）目录中找到自动生成的Interop.MSTSCLib.dll文件。
  2. 将该DLL复制到项目根目录下的lib文件夹，添加到项目并设置其“复制到输出目录”为“始终复制”。
  3. 修改Dockerfile中的msbuild命令，显式指定引用路径：

     RUN msbuild /p:Configuration=Release /p:ReferencePath=./lib ./ProjectName.csproj
     

• 方案2：使用NuGet包替代COM引用（推荐）
  在本地项目中安装MSTSCLib对应的NuGet包（直接在NuGet包管理器中搜索MSTSCLib即可找到预编译的互操作包）。这样nuget restore步骤会自动将包下载到容器中，msbuild构建时能直接识别引用，无需手动处理程序集。

• 方案3：在容器中注册COM组件（不推荐，仅作参考）
  如果必须使用原生COM引用，可以在Dockerfile中添加步骤注册对应的组件，但由于容器是极简环境，需要额外复制系统DLL并注册，步骤复杂且兼容性差，不建议采用。

内容的提问来源于stack exchange，提问作者Nicklas Gøthberg