NiFi 1.21.0中nifi-env.properties环境变量未同步至流程画布

核心原因 #

你在nifi-env.properties中定义的是系统级环境变量，这类变量供NiFi进程启动和底层运行时使用，并不会自动同步到NiFi流程画布的UI变量列表中——两者属于完全独立的变量体系：

• nifi-env.properties的变量：作用于NiFi进程本身，需要通过export前缀声明才能被进程加载；
• 画布UI的变量：是NiFi应用层面的变量管理机制（全局注册表/进程组变量），需要手动添加。

关键配置疏漏 #

从你提供的配置内容看，定义变量时缺少export前缀，正确写法应为：

export SFTP_PPK=/data/nifi/keys/sftp-private-key.ppk
export sftphost=sftp.server.com
export sftpuser=sftpuser

没有export的话，NiFi启动脚本不会把这些变量导出为进程可读取的环境变量，即使重启NiFi也无法生效。

两种使用方案 #

方案1：直接引用系统环境变量（无需UI变量列表） #

不需要在画布添加变量，直接在处理器的配置项中用${env:变量名}的语法引用，比如：

• 私钥路径：${env:SFTP_PPK}
• SFTP主机：${env:sftphost}
  注意：修改nifi-env.properties后必须重启NiFi，确保进程加载新的环境变量。

方案2：手动添加到NiFi应用层变量列表 #

如果希望在画布变量列表中看到这些值，可选择以下两种方式：

• 全局变量注册表：点击NiFi顶部导航栏的Variables按钮，添加对应的键值对，所有进程组都能引用；
• 进程组变量：进入目标进程组，点击右上角的Variables按钮添加，仅该进程组及其子进程组可引用。

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