Apache NiFi 1.13.2 ListenWebSocket处理器报错500无法运行如何解决

该错误是Apache NiFi 1.13.2版本的已知缺陷：ListenWebSocket处理器运行所需的Jetty WebSocket服务端依赖包未被默认纳入NiFi的类加载路径，导致WebSocket握手阶段触发类找不到异常，返回500错误。

方案1：手动补全依赖（无需升级NiFi版本） #

• 下载与NiFi内置Jetty版本完全匹配的依赖包，NiFi 1.13.2使用的Jetty版本为9.4.38.v20210224，需要下载两个Jar包：jetty-websocket-server-9.4.38.v20210224.jar、jetty-websocket-servlet-9.4.38.v20210224.jar
• 将下载完成的两个Jar包放入NiFi安装目录下的lib/文件夹中
• 停止NiFi进程，清空work/目录下的缓存文件，再重新启动NiFi服务，等待组件加载完成后即可正常使用ListenWebSocket处理器

方案2：升级NiFi版本 #

直接将NiFi升级到1.14.0及以上版本，该版本已官方修复了ListenWebSocket的依赖缺失问题，无需额外配置即可正常运行该处理器。

• 手动添加依赖时必须保证Jetty包版本和NiFi内置Jetty版本完全一致，否则会出现类冲突，引发更多运行异常
• 重启NiFi前清空work目录缓存，可以避免旧的类加载记录影响修复效果

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