Ubuntu22.04下Apache NiFi配置PutFile后无输出文件如何解决

核心问题定位 #

Ubuntu 22.04环境下PutFile无法写入/opt/nifioutput，90%以上的诱因是系统目录权限限制，剩余为处理器配置、数据流连通性问题，按以下步骤逐一排查配置即可：

• 第一步：修复目标目录权限
  /opt目录默认属主为root，普通用户无写入权限，NiFi默认以独立的nifi用户运行（apt安装/官方二进制包默认部署场景），无权限在/opt下创建目录、写入文件：
  1. 执行命令创建目标目录：sudo mkdir -p /opt/nifioutput
  2. 给NiFi运行用户分配目录所有权：默认部署场景执行sudo chown -R nifi:nifi /opt/nifioutput；如果是用个人账号直接解压启动NiFi，执行sudo chown -R $USER:$USER /opt/nifioutput
  3. 权限校验：切换到NiFi运行用户身份，执行touch /opt/nifioutput/test.txt，无报错即权限配置正常
• 第二步：核对PutFile必填参数配置
  所有参数不要填相对路径，严格按以下规则配置：
  • Directory：填绝对路径/opt/nifioutput，不要加末尾斜杠，不要带文件名
  • Create Missing Directories：设置为true，允许处理器自动创建缺失的子目录（该能力受目录上层权限限制，无父目录写权限时依然会报错）
  • Conflict Resolution Strategy：选择replace，避免同名文件导致处理器卡失败
  • Permissions：保留默认值rw-r--r--即可，无需手动修改
  • 不要勾选非必要的扩展选项，避免额外逻辑干扰
• 第三步：校验数据流与运行状态
  1. 确认GenerateFlowFile到PutFile的连接关系正确：连接的源关系必须选中GenerateFlowFile的success关系，没有错连到其他关系
  2. 两个处理器均需点击启动按钮，确认处理器右上角状态为绿色运行标识，无黄色告警、红色停止标识
  3. 右键PutFile选择「View data provenance」查看是否有流文件流入：如果无任何流文件记录，问题出在上游GenerateFlowFile配置，和PutFile无关
  4. 报错排查直接看NiFi运行日志，路径为NiFi部署目录下的logs/nifi-app.log，搜索PutFile关键字即可看到明确的报错原因（权限拒绝、路径不存在、磁盘满等）
• 快速验证技巧
  临时将PutFile的输出路径修改为/tmp/nifioutput（/tmp目录默认所有用户有读写权限），如果修改后能正常生成文件，可100%确认之前的故障是/opt目录权限配置错误导致，返回第一步重新配置权限即可。

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