ADF中SAP Table Connector连接测试报错：sapnco_utils程序集未找到求助

问题根源 #

你的报错是因为ADF的SAP连接器依赖SAP .NET Connector（NCo）3.1的sapnco_utils程序集，但该程序集未正确注册到全局程序集缓存（GAC）。SAP NCo 3.1版本的安装器取消了可视化的“Install assemblies in GAC”选项，需要手动完成GAC注册。

分步解决方案 #

1. 定位SAP NCo 3.1的程序集文件 #

默认安装路径下找到目标文件：

• 路径：C:\Program Files\SAP\SAP Connector for Microsoft .NET 3.1\assemblies\net40
• 需注册的文件：sapnco.dll、sapnco_utils.dll

2. 手动注册到GAC #

使用.NET Framework的gacutil.exe工具完成注册：

• 以管理员身份打开命令提示符（CMD）
• 切换到gacutil.exe所在目录（根据你的.NET SDK版本调整路径，示例路径针对.NET Framework 4.8）：

  cd "C:\Program Files (x86)\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools"
  

• 执行注册命令：

  gacutil /i "C:\Program Files\SAP\SAP Connector for Microsoft .NET 3.1\assemblies\net40\sapnco.dll"
  gacutil /i "C:\Program Files\SAP\SAP Connector for Microsoft .NET 3.1\assemblies\net40\sapnco_utils.dll"
  

• 确认输出显示“程序集已成功添加到全局程序集缓存”。

3. 验证GAC注册结果 #

• 打开目录C:\Windows\Microsoft.NET\assembly\GAC_MSIL，检查是否存在sapnco和sapnco_utils文件夹，且内部版本为3.1.0.42
• 或在管理员CMD中执行：

  gacutil /l sapnco_utils
  

  查看输出是否包含版本3.1.0.42的程序集记录。

4. 重启自托管集成运行时（IR） #

如果使用自托管IR，必须重启服务以加载新注册的程序集：

• 打开Windows“服务”控制台，找到Microsoft Azure Integration Runtime服务，右键选择“重启”

5. 版本匹配注意事项 #

• 确保安装的SAP NCo 3.1版本严格为3.1.0.42，与报错中要求的版本完全一致，避免混用不同版本的NCo组件
• 若使用托管IR，无需手动操作，Azure会维护所需组件；但自定义托管IR仍需按上述步骤部署程序集

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