Azure Data Factory自托管集成运行时程序集加载错误求助

问题背景 #

配置了使用自托管集成运行时（版本5.22.8297.1，部署在Windows VM）的ADF管道，包含Copy Activity和Azure Function Activity，执行时触发错误：

"Could not load file or assembly 'Microsoft.DataTransfer.ExternalActivities.Common, Version=1.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35' or one of its dependencies. The system cannot find the file specified."

问题原因 #

当前使用的自托管IR版本缺少支持Azure Function Activity运行的必要依赖组件Microsoft.DataTransfer.ExternalActivities.Common，或者该版本对Azure Function Activity的兼容性存在问题。

解决步骤 #

• 升级自托管IR至最新稳定版：微软会在后续IR版本中补充这类缺失的依赖并修复兼容性问题。直接在Windows VM上打开自托管IR配置管理器，点击更新按钮完成版本升级。
• 检查并修复IR安装完整性：若升级后问题依旧，查看IR默认安装目录C:\Program Files\Microsoft Integration Runtime\5.0\Shared下是否存在Microsoft.DataTransfer.ExternalActivities.Common.dll文件。如果缺失，卸载当前IR后重新下载最新版本安装包进行安装。
• 验证Azure Function Activity配置与网络连通性：确认Activity中填写的函数App名称、密钥等信息准确，同时确保自托管IR所在VM能正常访问目标Azure Function（检查防火墙规则、网络路由是否允许）。

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