必须声明application插件并正确配置mainClass，否则Gradle无法识别主类，导致“Could not find main class”等错误；Kotlin DSL用mainClass.set()，Groovy DSL用mainClassName=，二者不可混用。
build.gradle 里必须声明 application 插件和 mainClass
Gradle 默认不识别 Java 主类，不配就报 Could not find main class 或运行时提示 No main manifest attribute。关键不是写对包名，而是插件、属性、语法三者必须匹配。
用 Kotlin DSL（build.gradle.kts）时写法是：
plugins {
id("application")
}
application {
mainClass.set("com.example.App")
}
用 Groovy DSL（build.gradle）则必须用 mainClassName（注意是 ClassName，不是 Class）：
plugins {
id 'application'
}
application {
mainClassName = 'com.example.App'
}
- 包路径必须全小写，大小写错一个字母就找不到类
-
mainClass.set()和mainClassName =不能混用，否则 Gradle 会静默忽略后者 - 如果项目用了
java-library插件但没加application，gradle run直接失败
IntelliJ IDEA 里启动配置不生效？先看 run 任务是否能跑通
IDEA 的绿色三角按钮本质是调用 Gradle 的 run 任务，不是直接执行 java -cp ...。如果 gradle run 在终端报错，IDEA 也一定失败。
立即学习“Java免费学习笔记（深入）”；
常见断点排查顺序：
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 执行
gradle run，看是否输出Starting a Gradle Daemon和最终日志 - 检查
src/main/java下是否存在对应路径的.java文件（比如com/example/App.java），IDEA 不会自动创建目录结构 - 确认 IDEA 的 Project SDK 和 Module SDK 都指向了正确 JDK（JDK 17+ 项目配 JDK 21 会因字节码版本不兼容直接卡在类加载阶段）
- 如果改过包名或类名，删掉
build/目录再试，旧 class 文件残留会导致NoClassDefFoundError
gradle run 启动失败但 java -jar 成功？大概率是 application 插件没生效
打包成 jar 后能运行，说明主类存在且编译无误；但 gradle run 失败，90% 是构建脚本没触发 application 插件逻辑——尤其多模块项目中，只在子模块写了 mainClass，但根项目的 settings.gradle 没 include 它，或者子模块没 apply 插件。
验证方式：运行 gradle tasks | grep run，输出里必须有 run（来自 application 插件），而不是只有 test 或 compileJava。
- 多模块项目中，
application插件只能 applied 到含主类的模块，不能只放在根build.gradle - Spring Boot 项目不要用
application插件配mainClass，它自带bootRun任务，配了反而冲突 -
gradle run默认工作目录是项目根目录，如果代码里读了相对路径配置文件，可能因路径错导致空指针
Spring Boot 项目别碰 mainClass，用 bootRun 代替
Spring Boot Gradle 插件会接管启动流程，硬塞 mainClass 会导致 gradle run 和 bootRun 行为不一致，甚至 bootRun 报 Unable to find main class。
正确做法是删掉 application 块，只保留：
plugins {
id 'org.springframework.boot' version '3.3.4''
// 不要加 id 'application'
}
// mainClass 配置全部删除
然后统一用 gradle bootRun 启动，它会自动扫描带 @SpringBootApplication 的类。
- 如果
bootRun找不到主类，检查类上是否有@SpringBootApplication，且该类在src/main/java下 -
bootRun支持参数，比如gradle bootRun --args='--server.port=8081' - 开发时用
bootRun，上线用gradle build出 jar 再java -jar，两者启动机制完全不同，别混着调
最常被忽略的是：Gradle 构建脚本里的插件顺序和作用域。一个 apply plugin: 'application' 写在 subprojects 闭包外，或写在 buildscript 里，都会让配置失效——它必须出现在模块级 build.gradle 的顶层作用域。
