无法通过Azure DevOps Pipeline部署含Microsoft.Office.Interop.Word的.NET Core应用

问题根源 #

你碰到的MSB4803错误是因为.NET Core版本的MSBuild不支持COM引用解析，而且Azure DevOps默认构建代理没有安装Microsoft Office——就算搞定构建，运行时也会因为缺失Office COM组件失败。CS0234是构建时找不到Interop程序集的连锁错误。

可行解决方案 #

1. 迁移到.NET Framework #

Office Interop对.NET Framework的COM互操作支持更完善，而且能在Azure DevOps的Windows代理上正常构建：

• 把项目从.NET Core转成.NET Framework（推荐4.7.2及以上版本）
• 用NuGet包Microsoft.Office.Interop.Word替换本地COM引用，避开ResolveComReference的问题
• Azure DevOps Pipeline里选windows-latest作为构建代理，确保环境支持.NET Framework和Interop构建

2. 用无Office依赖的开源库替代 #

如果要保留.NET Core/.NET 5+，换用不需要安装Office的开源库实现Word对比：

• DocX：基于OpenXML，支持文档对比，轻量跨平台
• OpenXML SDK：微软官方库，需自行编写对比逻辑，但完全免费
• GroupDocs.Comparison：商业库，开箱即用的对比功能，支持多格式

DocX对比示例代码：

using DocX;

// 加载文档
using var doc1 = DocX.Load("doc1.docx");
using var doc2 = DocX.Load("doc2.docx");

// 生成对比文档
var diffDoc = doc1.Compare(doc2);
diffDoc.Save("对比结果.docx");

3. 自定义Azure DevOps代理安装Office（不推荐） #

如果坚持用Interop.Word，得在构建代理上装Office：

• 搭建自定义Azure DevOps代理，在代理机器上手动装授权的Microsoft Office
• Pipeline里加PowerShell脚本自动安装Office Click-to-Run版本（注意版权合规）
• 项目里提前打包Interop程序集，避免构建时依赖COM解析

重要提醒 #

• Office Interop只能在Windows环境运行，没法在Linux/macOS的Azure服务或容器里用
• 运行时环境必须装对应版本的Office，否则会抛COMException
• 无Office依赖的库是跨平台部署和长期维护的最优选择

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