.NET运行报错：未找到Interop.Microsoft.Office.Core程序集排查

问题现象 #

在新系统运行多年前开发的旧.NET项目，项目引用了Microsoft.Office.Interop.Excel、Microsoft.Office.Interop.Outlook、Microsoft.Office.Interop.Word等Office互操作组件，运行时抛出如下错误：

未能找到文件或程序集“Interop.Microsoft.Office.Core”或它的某一个依赖项。试图加载格式不正确的程序。

对应的程序集绑定日志如下：

=== State information before binding ===
LOG: DisplayName = Interop.Microsoft.Office.Core
 (Partial.)
WRN: Partial binding information was provided for an assembly:
WRN: Assembly name: Interop.Microsoft.Office.Core | Domain ID: 2
WRN: Partial binding occurs when only part of the assembly display name is provided.
WRN: This may cause the collection folder to load an incorrect assembly.
WRN: Specify the text identity of the assembly with full details. 
WRN: This includes the simple name, version and culture, and public key token.
LOG: Appbase = file:///C:/Users/krebesli/OneDrive - TRUMPF SE + Co. KG/Project - Copy/TruTopsSales/TruTopsSales/
LOG: Original PrivatePath = C:\Users/krebesli/OneDrive - TRUMPF SE + Co. KG\Project - copy\TruTopsSales\TruTopsSales\bin
Call from Assembly : (Unknown).
===
LOG: This binding starts in default load context.
LOG: The application configuration file is used: C:\Users\krebesli\OneDrive - TRUMPF SE + Co. KG\Project - copy\TruTopsSales\TruTopsSales\web.config.
LOG: The host configuration file is used: \srvditz1\home$\krebesli\Documents\IISExpress\config\aspnet.config.
LOG: The computer configuration file of C:\Windows\Microsoft.NET\Framework64\v4.0.30319\config\machine.config is used.
LOG: policy is not currently applied to the reference (private, custom, partial, or path-based assembly binding).
LOG: download of new URL file:///C:/Users/(username)/AppData/Local/Temp/Temporary ASP.NET Files/vs/2636e7dd/88283cb5/Interop.Microsoft.Office.Core.DLL.
LOG: Download of new URL file:///C:/Users/(username)/AppData/Local/Temp/Temporary ASP.NET Files/vs/2636e7dd/88283cb5/Interop.Microsoft.Office.Core/Interop.Microsoft.Office.Core.DLL.
LOG: Download from new URL file:///C:/Users/(username)/.../.../.../bin/Interop.Microsoft.Office.Core.DLL.
ERR: Assembly setup could not be completed (hr = 0x8007000b). The search was terminated.

已尝试的无效操作 #

• 删除Microsoft.Office.Core引用，错误仍然出现
• 移除所有Office相关引用，通过引用管理器的COM选项卡重新添加Microsoft Office 16.0 Object Library

已发现的异常点 #

• 在引用选项卡中搜索“office”无任何匹配结果
• 查看office.core引用属性时，*复制本地（Local Copy）*选项为false且无法修改

根因说明 #

错误码0x8007000b是典型的程序集平台格式不匹配问题，从绑定日志可以看到当前加载的是64位.NET Framework运行环境，和本机安装的Office、互操作程序集的位数不一致。另外引用搜不到、复制本地选项不可用，是因为安装Office时没有勾选.NET可编程性支持组件，Office主互操作程序集（PIA）没有正确注册到系统。

排查解决步骤 #

1. 对齐平台目标位数
   • 右键项目进入「属性-生成」页，把平台目标从默认的Any CPU改成和本机Office一致的位数：32位Office选x86，64位Office选x64，选x64时要取消勾选“首选32位”。
   • 如果用IIS Express调试，还要进入VS「工具-选项-项目和解决方案-Web项目」，对应调整“对网站和项目使用IIS Express的64位版本”的勾选状态，保证和项目平台目标一致。
2. 补装Office的.NET可编程性支持
   • 打开控制面板「程序和功能」，找到已安装的Microsoft Office，右键选择「更改-添加或删除功能」。
   • 展开Excel、Word、Outlook等用到的Office组件节点，找到「.NET可编程性支持」项，设置为“从本机运行”，完成安装后重启电脑。这一步操作后，VS引用管理器的COM选项卡就能正常搜到Microsoft Office对应版本的Object Library。
3. 彻底清理残留错误引用
   • 右键项目选择「卸载项目」，再右键选择「编辑csproj文件」，把所有包含Office、Interop.Microsoft.Office.Core的<Reference>节点全部删除，保存后重新加载项目。
   • 手动删除项目目录下bin、obj文件夹的所有旧编译文件，再重新添加对应版本的Office互操作引用。
   • 如果还是遇到复制本地无法修改的问题，可以直接通过NuGet安装对应版本的Office Interop包，不需要依赖系统COM注册的版本，安装后互操作DLL会自动复制到输出目录。
4. 重装判断
   不需要重装.NET运行环境，绝大多数这类问题通过上面三步就能解决。只有完成上述操作后还是找不到Office COM组件时，再考虑修复/重装Office，尽量选择和旧项目开发时一致的Office大版本，避免版本差导致的互操作兼容问题。

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