Windows运行Flink Jar遇ClassNotFoundException: org.apache.flink.client.CliFrontend

问题分析 #

报错信息为：

错误: 找不到或无法加载主类 org.apache.flink.client.cli.CliFrontend
原因: java.lang.ClassNotFoundException: org.apache.flink.client.cli.CliFrontend

这是因为你在Windows环境下错误使用了Linux/Unix专属的.sh脚本，导致Flink的环境变量没有正确加载到终端会话中。

解决步骤 #

• 关闭当前运行start-local.sh的终端，打开Windows命令提示符(CMD)或PowerShell
• 执行Windows版的Flink本地启动脚本：

  .\bin\start-local.bat
  

• 保持该终端窗口处于打开状态，接着运行WordCount示例：

  .\bin\flink.bat run .\examples\batch\WordCount.jar
  

关键说明 #

Flink为不同系统提供了对应脚本：.sh后缀是给Linux/macOS用的，Windows环境必须用.bat后缀的脚本。之前用start-local.sh能启动是因为终端兼容Shell语法，但后续执行客户端命令时，环境变量未被正确注入，最终导致找不到主类。

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