IntelliJ运行Maven构建应用首次启动报找不到主类故障排查

你的推测完全准确，这是IntelliJ IDEA Application类型运行配置的固定执行时序设计导致的：

• IDEA启动Application运行配置时，会在所有Before Launch队列里的任务开始执行前，就提前完成类路径扫描、主类存在性校验、输出目录索引缓存的初始化。如果此时Maven编译还没执行，target/classes目录下不存在对应主类的字节码文件，IDEA会直接判定主类不存在，抛出你看到的错误：

Error: Could not find or load main class xx.Main
Caused by: java.lang.ClassNotFoundException: xx.Main

• 首次运行失败后第二次启动正常、单独先跑Maven编译再启动正常，本质都是因为前序操作已经把字节码文件输出到了target/classes目录，IDEA预扫描类路径时能直接找到主类，自然不会报错。
• 无论你在Before Launch里加Maven compile还是完整的package/build目标都没用，因为类路径预加载的节点早于所有Before Launch任务的执行节点，和Maven任务本身是否执行成功无关。

以下方案都可以实现单步点击完成编译+启动，不需要开发者额外操作，适合给初级开发者统一配置：

• 方案1（最推荐，零兼容问题）：使用Maven类型运行配置绑定启动目标
  操作步骤：
  1. 新建Maven类型的运行配置，选中对应项目模块
  2. 在「命令行」输入框填入compile exec:java -Dexec.mainClass="xx.Main"，如果需要自定义JVM参数追加-Dexec.jvmArgs="你的JVM参数"，需要传程序启动参数追加-Dexec.args="参数1 参数2"即可
  3. 将该运行配置设为IDE顶部工具栏默认选中的配置，使用者直接点绿色运行按钮即可自动完成编译、启动全流程，没有额外操作成本。
     这个方案完全绕开了IDEA Application配置的类路径预加载逻辑，Maven会严格按照生命周期顺序先完成编译再执行启动，从机制上避免了首次启动类找不到的问题。
• 方案2（需保留Application配置特性时使用）：调整Before Launch任务顺序强制刷新缓存
  如果你需要用到Application配置专属的能力（比如IDEA原生热更新、字节码增强工具集成等），按以下步骤调整配置即可：
  1. 打开原有Application运行配置，找到Before Launch配置栏
  2. 移除之前添加的所有Maven编译类任务
  3. 按顺序添加两个任务：第一个选Run Maven Goal，目标填clean compile；第二个选IDEA自带的Build动作，确保Build动作排在Maven任务之后
     原理是Maven编译完成后，IDEA自带的Build动作会强制刷新target/classes目录的索引缓存，等所有前置任务跑完再启动主类时，就能正确识别到刚编译生成的字节码文件。

注意：不需要开启「将IDE构建/运行操作委托给Maven」的全局/项目配置，该选项会拉长启动耗时，且对新手来说出现问题时排查链路更长，上述两个方案都不需要开启该选项。

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