Apache NiFi重启后localhost:8443无法加载登录GUI仅显示乱码问题

排查思路 #

• 响应编码与压缩协商异常验证
  执行命令curl -v https://localhost:8443/nifi -k抓取本地访问的原始响应，重点核对两个响应头字段：
  • Content-Type：正常返回值应为text/html;charset=utf-8，如果显示为application/octet-stream或缺失charset字段，说明服务端响应类型识别错误
  • Content-Encoding：正常启用压缩时返回值为gzip，如果该字段缺失但响应体是gzip格式二进制流，说明浏览器与服务端的压缩协商失败，浏览器会直接把二进制压缩包当文本渲染，表现为乱码
• 浏览器缓存兼容验证
  打开Firefox隐私浏览窗口访问https://localhost:8443/nifi，如果隐私窗口下页面正常渲染，说明是普通窗口下的本地HTTPS站点缓存错位导致：NiFi首次启动写入的静态资源缓存，和主机重启后服务端重新生成的资源签名不匹配，Firefox未重新拉取完整资源直接用旧缓存解析触发乱码。
• 运行目录权限验证
  进入NiFi安装目录执行ls -ld work/ work/jetty/，检查目录属主：如果之前用root账号执行过启动命令，主机重启后用普通用户启动NiFi，会因为work目录（Jetty存放临时编译静态资源的目录）无读写权限，返回错误的二进制内容。
• 配置一致性验证
  打开conf/nifi.properties核对web压缩相关配置，首次启动后如果配置写入异常，会导致压缩规则匹配到HTML响应类型之外的二进制资源，返回错误内容。

可落地修复方案 #

• 临时缓存问题修复
  普通窗口下按Ctrl+Shift+Delete勾选「缓存」「站点离线数据」执行清除，之后按Ctrl+F5强制刷新页面即可临时恢复；如果需要永久规避Firefox本地回环访问的缓存bug，访问时用虚拟机分配的IP地址代替localhost即可。
• 压缩协商异常修复
  打开conf/nifi.properties，找到压缩配置项修改为以下默认值，或直接关闭压缩（本地部署场景无性能影响）：

  # 可直接设置为false关闭压缩彻底规避协商问题
  nifi.web.http.compression.enabled=false
  # 若保留压缩则确保mime-types配置如下
  nifi.web.http.compression.mime-types=text/html,text/xml,text/plain,text/css,text/javascript,application/javascript,application/json,application/xml
  nifi.web.http.compression.minimum-size=1024
  

  修改完成后执行bin/nifi.sh restart重启服务生效。
• 目录权限问题修复
  先停止NiFi服务：bin/nifi.sh stop，删除异常的临时工作目录：rm -rf work/，再把整个NiFi安装目录的属主修正为实际启动服务的用户：chown -R <当前启动NiFi的系统用户名>:<当前启动NiFi的系统用户名> ./，重新启动服务即可，启动时会自动重建work目录下的静态资源缓存。

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