Kafka主类位于何处？如何在IntelliJ IDEA中配置Kafka源码的运行调试参数

常见报错的本质 #

网上流传的Kafka源码配置教程大多是2018年前后的老内容，和当前主分支的项目结构、构建逻辑已经相差近10个版本，出现的两个典型问题根本不是操作错了，是教程和实际代码版本不匹配：

• 找不到kafka.Kafka类：不是类被移除了，是IDEA导入Gradle项目时没有自动识别Scala源码目录，导致类不被索引
• -cp参数找不到core_main配置项：这是老版本IDEA导入早期Kafka源码时自动生成的临时模块名，现在新版本Gradle导入后已经完全废弃

第一步：修复源码索引问题，定位kafka.Kafka类 #

• 在项目左侧目录树找到core/src/main/scala路径，右键点击该文件夹，选择「标记目录为 -> 源代码根目录」
• 标记完成后，按两次Shift打开全局搜索，输入Kafka.scala，就能直接找到对应源码文件，其类的全限定名就是kafka.Kafka，和老教程提到的类名完全一致

第二步：创建可调试的Application运行配置 #

注意：千万不要选Gradle类型的运行配置，这类配置启动的Scala进程会导致代码断点完全失效，无法正常调试
新建「Application」类型的运行配置，逐项按要求填写：

• 配置名称：可自定义，比如本地Kafka Broker源码启动
• 主类：手动输入全限定名kafka.Kafka，等源码索引完成后IDEA会自动校验类有效性，不会出现红色标识
• 类路径模块：下拉选择core模块（这就是当前版本下主类对应的正确模块，替代老教程提到的core_main选项）
• 程序参数：填写本地Broker配置文件的相对路径：如果是2.8之后的KRaft新版本，填config/kraft/server.properties；如果是依赖ZooKeeper的2.8之前老版本，填config/server.properties
• 工作目录：保持默认的Kafka源码项目根目录即可，不要手动修改

额外提醒：不要手动在VM参数里添加-cp类路径参数，IDEA会自动组装core模块下所有编译输出、Scala运行时依赖、第三方Jar包的完整路径，手动填写-cp会直接覆盖自动生成的正确路径，反而引发类找不到的报错

第三步：启动前的前置校验，避免低级报错 #

• 打开你在程序参数里填写的配置文件，找到log.dirs对应的日志存储路径，提前在本地创建好对应空目录，避免启动时报日志目录不存在的错误
• 如果使用的是2.8之前需要依赖ZooKeeper的老版本源码，需要单独新建一个运行配置启动ZooKeeper：主类填org.apache.zookeeper.server.ZooKeeperServerMain，程序参数填config/zookeeper.properties，先启动ZooKeeper再启动Broker即可
• 调试时直接在对应代码行打断点，点击Debug按钮启动配置即可，IDEA会自动挂载调试器，不需要额外添加远程调试参数

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