Azure Data Factory访问自托管IR的F盘时出现AccessToOnPremFileSystemDenied错误

问题场景 #

此前一直通过Azure Data Factory（ADF）的自托管集成运行时（IR）访问本地F盘，突然触发以下错误：

错误代码：AccessToOnPremFileSystemDenied
故障类型：用户配置问题
详细信息：ErrorCode=AccessToOnPremFileSystemDenied,'Type=Microsoft.DataTransfer.Common.Shared.HybridDeliveryException,Message=Access to 'F:' is not allowed.,Source=Microsoft.DataTransfer.Common

排查与解决步骤 #

结合官方排查方案，整理以下解决思路：

• 检查自托管IR的允许路径配置：自托管IR默认会限制可访问的本地磁盘目录。进入ADF门户找到对应自托管IR，在「配置」板块的「允许的路径」中确认是否添加了F:\（或你需要访问的具体子路径），未添加则补充后重试。
• 验证IR运行账户权限：确保自托管IR服务所使用的运行账户对F盘具备所需的读写权限（根据你的管道操作需求），若近期账户权限有变更需重点检查。
• 升级自托管IR版本：旧版本可能存在配置兼容问题，将自托管IR升级至最新稳定版本后再测试访问。
• 确认路径格式正确性：在ADF管道配置中，确保磁盘路径使用F:\这类完整格式，避免仅写F:导致路径解析错误。

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