使用NUnit测试VSTO Excel插件COM对象时遇HRESULT:0x80004002错误

核心问题分析 #

你遇到的InvalidCastException (HRESULT: 0x80004002)虽常和并发/线程单元不匹配相关，但测试类内转换正常、主项目报错且线程确认为STA，说明问题不在线程模型本身，而是COM对象的跨上下文/域访问或Interop组件的类型匹配细节导致的。

针对性解决方案 #

1. 用原生接口查询替代强制类型转换 #

Workbook.CustomDocumentProperties返回的是object类型，直接强转DocumentProperties可能因COM包装器上下文冲突失败，换用Marshal.QueryInterface获取接口：

using System.Runtime.InteropServices;
using Microsoft.Office.Core;
using Microsoft.Office.Interop.Excel;

// 替换原强转代码：DocumentProperties props = (DocumentProperties)workbook.CustomDocumentProperties;
object propsObj = workbook.CustomDocumentProperties;
DocumentProperties props = null;
IntPtr ptr = Marshal.GetIUnknownForObject(propsObj);
try
{
    Marshal.QueryInterface(ptr, typeof(DocumentProperties).GUID, out IntPtr propsPtr);
    props = Marshal.GetObjectForIUnknown(propsPtr) as DocumentProperties;
}
finally
{
    Marshal.Release(ptr);
}

2. 确保主项目与测试项目的Interop版本完全一致 #

主项目和测试项目必须引用**同一版本（15.0.0.0）**的Microsoft.Office.Core和Microsoft.Office.Interop.Excel组件：

• 检查两边的NuGet包或COM引用版本是否匹配
• 清理解决方案，删除bin/obj目录后重新编译

3. 显式管理COM对象生命周期 #

主项目中使用完COM对象后及时释放，避免残留包装器干扰类型转换：

if (props != null)
{
    Marshal.ReleaseComObject(props);
    props = null;
}

4. 调整NUnit的ApartmentState配置优先级 #

NUnit 4.x中特性组合有优先级要求，在测试类上同时添加：

[Apartment(ApartmentState.STA)]
[SingleThreaded]
public class YourTestClass
{
    // 测试代码
}

同时确保.runsettings配置生效：

<RunSettings>
  <NUnit>
    <NumberOfTestWorkers>1</NumberOfTestWorkers>
  </NUnit>
</RunSettings>

运行测试时需指定该配置文件。

5. 避免跨AppDomain传递COM对象 #

若主项目和测试代码处于不同AppDomain，COM对象无法直接跨域转换：

• 测试方法内直接初始化并调用主项目功能，不要通过跨域代理
• 避免使用可能触发跨域的NUnit特性（如[TestFixtureSetUp]的特殊场景）

验证步骤 #

1. 在主项目中写一个简单的控制台测试代码，直接执行转换逻辑，确认是否仍报错
2. 若控制台测试正常，说明问题出在NUnit测试上下文与主项目的交互上
3. 逐步排查测试中对象的传递方式，是否存在隐式跨上下文操作

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