Apache NiFi PutFile处理器无法写入Windows共享网络路径问题

核心报错根因 #

NiFi在Windows工作站以系统服务形式运行时，默认采用Local System本地系统账户启动，该账户不具备跨网络访问UNC格式SMB共享路径的权限，这也是为什么本地C盘路径写入完全正常、但写入\\sharedpath\files\destination这类网络共享路径时会触发权限类报错的核心原因。

可落地的解决步骤 #

• 调整NiFi服务的运行身份到有共享权限的账号
  1. 按下Win+R输入services.msc打开Windows服务管理器，定位到Apache NiFi对应的服务项
  2. 右键打开服务属性面板，切换到「登录」配置页
  3. 取消默认的「本地系统帐户」选项，选择「此帐户」，填入对目标共享路径拥有读写权限的账号（域账号或和共享端权限匹配的本地账号均可），填写对应账号的登录密码
  4. 保存配置后重启NiFi服务，让权限配置生效
• 系统级映射共享盘符规避UNC访问限制
  如果不便调整服务运行账号，可以将目标共享路径映射为系统级的固定盘符，绕开UNC路径的权限校验问题：
  1. 以管理员身份打开命令提示符，执行映射命令：net use N: \\sharedpath\files\destination /persistent:yes
  2. 注意：必须使用管理员权限执行映射命令，普通用户在资源管理器里手动映射的盘符，对后台运行的系统服务是不可见的
  3. 映射完成后，直接在PutFile处理器的「Directory」配置项中填入映射后的盘符路径N:\即可正常写入
• 处理器配置的细节避坑
  • PutFile的目录配置不要加尾部反斜杠，正确写法为\\sharedpath\files\destination，避免因路径格式校验失败报错
  • 如果开启了PutFile的「Create Directory」属性，要提前确认运行NiFi的账号对共享路径拥有子目录创建权限，否则会直接抛出IO异常
  • 填写UNC路径时统一使用Windows格式的反斜杠，不要混用正斜杠

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