Azure Data Factory连接本地NFS共享测试连接报网络路径未找到问题咨询

访问文件夹'\[server_name][folder_name]$'下文件时出错，文件过滤器：'*'，网络路径未找到，Activity ID: XXX

1. 优先排查集成运行时配置 #

• 接入非Azure环境的本地资源必须使用自托管集成运行时(SHIR)，不可使用Azure默认集成运行时
• 确认自托管集成运行时部署在和本地NFS服务器网络互通的内网机器上，配置连接时连接器选中该自托管运行时

2. 排查连接器与路径配置错误 #

• 确认在ADF中选择的是「NFS」连接器，不可用SMB/文件系统连接器连接NFS共享
• 修正NFS路径格式，NFS标准路径格式为 [NFS服务器IP/主机名]:/[导出的共享目录路径]，不可使用Windows SMB的\\[server_name][folder_name]$格式
• 确认NFS服务器版本为v3或v4.1，ADF NFS连接器仅支持这两个版本

3. 本地网络连通性校验 #

所有校验操作需要在部署自托管集成运行时的机器上执行：

• 执行ping [NFS服务器IP/主机名]检查网络是否可达，不可达先排查本地路由、子网 ACL 配置
• 执行telnet [NFS服务器IP] 2049和telnet [NFS服务器IP] 111检查NFS服务默认端口（2049）、rpcbind端口（111）是否放通，两端防火墙、安全组需允许这两个端口的入出站请求
• 手动挂载NFS共享到本地，验证可以正常读写目标目录，确认NFS服务端的导出配置允许自托管IR机器的IP访问该共享

4. 权限配置校验 #

• NFS v3默认基于UID/GID、客户端IP做权限校验，无需填写用户名密码，配置时留空对应字段即可
• NFS v4需确认填写的用户名密码符合服务端的用户映射规则，对目标共享目录有读写权限

5. 兜底排查方案 #

• 升级自托管集成运行时到最新版本，旧版本存在NFS连接相关的已知兼容问题
• 结合Activity ID在ADF监控面板查询完整错误栈，同时提取自托管集成运行时本地日志做进一步定位

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