Azure自托管集成运行时注册失败：密钥无效或为空求助

密钥本身排查 #

• 确认密钥有效性：在Azure Data Factory门户的自托管IR「授权密钥」页，重新生成主/辅助密钥（旧密钥可能已过期），复制时确保选中完整密钥字符串，避免截断。
• 清除冗余字符：将密钥先粘贴到纯文本编辑器（如记事本），删除可能存在的空格、换行符或不可见字符后，再复制到注册框。
• 验证账户权限：确保操作的Azure账户拥有Data Factory的Contributor或Integration Runtime Contributor权限，无权限生成的密钥可能无法正常使用。

本地环境与网络排查 #

• 测试连通性：在Windows服务器上执行命令验证与Azure服务的连通性：

  Test-NetConnection -ComputerName adf.azure.com -Port 443
  

  使用Express Route的话，确认路由规则已开放自托管IR与Azure Data Factory的通信端口。
• 临时关闭安全软件：本地防火墙、杀毒软件可能拦截IR的注册请求，临时关闭后重试，若成功则为IR添加通信例外规则。
• 检查安装目录权限：确保自托管IR默认安装目录C:\Program Files\Microsoft Integration Runtime\5.0拥有读写权限，避免密钥无法写入配置文件。

注册方式调整 #

• 改用命令行静默注册：跳过图形界面，执行以下命令（替换<AUTH_KEY>为你的有效密钥）：

  "C:\Program Files\Microsoft Integration Runtime\5.0\Shared\Microsoft.DataTransfer.IntegrationRuntime.Management.exe" -Register -Key <AUTH_KEY>
  

• 彻底重装IR：完全卸载现有IR，删除安装目录及注册表项HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\DataTransfer\IntegrationRuntime（提前备份注册表），再下载最新稳定版MSI安装包重新安装。

日志定位问题 #

查看IR注册日志文件C:\Program Files\Microsoft Integration Runtime\5.0\Shared\Logs\IntegrationRuntimeManagement.log，查找「Invalid key」「Authentication failed」等关键词，定位具体报错原因。

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