启动Apache NiFi时出现java.net.BindException绑定异常如何解决

问题根因定位 #

该Cannot assign requested address报错不是8080端口占用导致，报错栈指向NiFiListener.start，是NiFi bootstrap进程内部通信监听地址绑定失败，和NiFi web服务的8080端口无关，所以排查8080端口占用无法定位问题。

排查步骤 #

1. 检查bootstrap.conf监听配置 #

打开NiFi配置目录下的bootstrap.conf文件，检查以下两个配置项：

# bootstrap内部通信监听地址，默认值为127.0.0.1
nifi.bootstrap.listen.address=
# bootstrap内部通信监听端口，默认随机分配
nifi.bootstrap.listen.port=

如果nifi.bootstrap.listen.address配置了当前服务器不存在的IP（例如之前绑定过公网IP后IP变更、内网IP填写错误、网卡被删除导致原有IP失效），就会触发绑定失败异常。

修复方案：将nifi.bootstrap.listen.address改为127.0.0.1或者留空（留空默认绑定所有网卡的0.0.0.0地址），保存配置。

2. 检查系统网络配置 #

如果bootstrap配置无问题，继续排查系统层面网络限制：

• 检查lo回环接口状态，执行ifconfig lo确认接口状态为UP，且已配置127.0.0.1地址
• 检查系统可用端口范围，执行cat /proc/sys/net/ipv4/ip_local_port_range确认端口范围足够，可用端口耗尽也会导致随机端口绑定失败
• 检查SELinux状态，执行getenforce如果返回Enforcing，执行setenforce 0临时关闭SELinux后再尝试启动，确认是否是安全策略限制端口绑定
• 检查iptables/ufw等防火墙规则，确认没有禁止本地端口绑定的规则

3. 清理残留文件并重启NiFi #

配置修改完成后执行以下操作启动服务：

1. 清理NiFi运行目录下的残留进程文件：rm -rf /home/nifi-1.12.0/run/*
2. 执行启动命令：/home/nifi-1.12.0/bin/nifi.sh start
3. 启动完成后执行netstat -tunlp | grep java，确认8080端口和bootstrap监听端口均正常绑定即可。

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