Docker镜像构建失败：MODI COM引用未找到问题求助

问题根源 #

1. MODI的平台局限性：MODI是微软旧版Office（2003/2007）专属的COM组件，仅支持Windows系统，Docker默认的Linux镜像完全没有这个组件；即使是Windows镜像，默认也不会预装MODI。
2. .csproj引用被跳过：你.csproj里的<COMReference>带有Condition="'$(MSBuildRuntimeType)' != 'Core'"，如果Docker使用的是.NET Core/.NET 5+的SDK镜像，这个引用会被MSBuild忽略，直接导致编译时找不到MODI类型。
3. 容器内无COM类型库：即便去掉Condition，容器里没有MODI的类型库文件（MSMODI.tlb），tlbimp工具无法自动生成互操作程序集，编译依然失败。

解决方案 #

1. 替换为跨平台OCR库（优先推荐） #

MODI已经停止维护多年，完全不适合容器化环境，直接替换为跨平台的OCR方案：

• Tesseract.NET：开源本地OCR库，支持Windows/Linux/macOS，通过NuGet安装Tesseract包即可使用。
• Azure计算机视觉OCR：云服务，无需本地依赖，调用API即可完成图像转文本，适合分布式部署。

替换后删除项目中的COM引用，直接通过NuGet管理依赖，Docker构建时会自动处理，彻底解决兼容性问题。

2. 必须使用MODI？只能用Windows容器 #

如果业务必须保留MODI，只能基于Windows容器构建，步骤如下：

（1）更换Docker基础镜像

使用Windows Server Core的.NET SDK镜像，比如：

FROM mcr.microsoft.com/dotnet/sdk:6.0-windowsservercore-ltsc2019

（2）在容器内安装MODI组件

MODI属于Office 2007的可选组件，需要在Dockerfile中添加静默安装步骤（需准备Office 2007安装介质）：

# 复制Office安装包到容器临时目录
COPY Office2007Setup.exe /temp/
# 静默安装仅MODI组件
RUN start /wait msiexec.exe /i C:\temp\Office2007Setup.exe /quiet ADDLOCAL=MODI

（3）修改.csproj引用条件

删除<COMReference>节点中的Condition属性，确保Windows容器环境下MSBuild会加载该引用：

<ItemGroup>
    <COMReference Include="MODI">
      <WrapperTool>tlbimp</WrapperTool>
      <VersionMinor>0</VersionMinor>
      <VersionMajor>12</VersionMajor>
      <Guid>a5ededf4-2bbc-45f3-822b-e60c278a1a79</Guid>
      <Lcid>0</Lcid>
      <Isolated>false</Isolated>
      <EmbedInteropTypes>true</EmbedInteropTypes>
    </COMReference>
  </ItemGroup>

3. 预生成互操作程序集（折中方案） #

在本地Windows环境下，使用tlbimp工具提前生成MODI的互操作程序集：

tlbimp "C:\Program Files\Common Files\Microsoft Shared\MODI\12.0\MSMODI.tlb" /out:MODI.dll

将生成的MODI.dll添加到项目中，替换原来的COM引用（改为普通程序集引用），然后在Dockerfile中复制该DLL到容器的输出目录，这样无需在容器内安装MODI，但仍然只能在Windows容器中运行。

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