Docker容器中Apache NiFi 1.19频繁自动重启问题排查求助

1. 抓取容器底层运行日志 #

• 执行 docker logs --follow --tail 100 <容器ID/名称> 实时跟踪输出，哪怕容器重启也能捕获崩溃前的最后日志
• 用 docker inspect <容器ID> 查看容器状态细节，重点看State字段的退出码、启动失败原因，以及Mounts确认卷挂载的权限映射是否正常（Windows环境下Docker目录挂载易出现权限问题）

2. 检查Docker资源分配 #

• 打开Docker Desktop的Resources设置，确认给容器分配的内存不低于2G（NiFi 1.19建议4G以上），内存不足会触发OOM导致进程被杀死
• 检查Docker存储目录的磁盘剩余空间，存储空间不足会直接导致容器启动失败后重启

3. 手动启动NiFi进程排查 #

• 启动容器时覆盖默认命令进入交互模式：docker run -it --entrypoint bash apache/nifi:1.19.0
• 在容器内手动执行./bin/nifi.sh start，然后实时查看./logs/nifi-app.log和./logs/nifi-bootstrap.log，这两个日志会记录NiFi启动阶段的所有细节，包括底层错误

4. 排查端口与网络问题 #

• 在Windows终端执行netstat -ano | findstr <NiFi端口>，检查8080、8443等默认端口是否被其他程序占用，端口冲突会导致容器启动失败重启
• 切换Docker网络模式，比如从bridge改为host（需开启WSL2后端），测试是否为网络配置导致的启动异常

5. 验证镜像与环境变量 #

• 重新拉取官方镜像：docker pull apache/nifi:1.19.0，避免镜像损坏引发的启动问题
• 显式设置JVM相关环境变量，避免默认参数不足：

  docker run -d -p 8080:8080 -e NIFI_JVM_HEAP_INIT=2g -e NIFI_JVM_HEAP_MAX=4g apache/nifi:1.19.0
  

6. 排查WSL2后端兼容性（Windows 10专属） #

• 确认Docker使用WSL2后端而非Hyper-V，WSL2对容器的兼容性更稳定
• 执行wsl --update更新WSL2内核版本，旧版本内核可能存在容器进程异常退出的问题
• 编辑%USERPROFILE%\.wslconfig文件，设置WSL2的合理资源限制：

  [wsl2]
  memory=6GB
  processors=4
  

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