Java项目启动异常需优先定位栈顶Caused by，再查依赖树、配置文件和环境兼容性。常见原因包括类路径冲突、配置占位符未定义、Spring Bean初始化失败及JVM版本不匹配。
Java项目启动时抛异常，核心是定位异常源头——看控制台第一行红色错误（通常是Exception in thread "main"或Caused by:），再结合栈追踪逐层向上分析。
检查类路径与依赖冲突
常见于NoClassDefFoundError、ClassNotFoundException或AbstractMethodError。说明JVM找不到类，或加载了不兼容版本的类。
- 用
mvn dependency:tree -Dverbose查依赖树，确认是否有重复引入、版本打架（比如两个不同版本的Spring Core） - 检查
target/classes或out/production下对应类是否存在；IDE中右键模块 → “Reload project” 同步Maven/Gradle - 若用IDEA，打开
File → Project Structure → Modules → Dependencies，删掉冗余的jar或“Library”引用
验证配置文件与资源加载
FileNotFoundException、IllegalArgumentException: Could not resolve placeholder多源于配置问题。
- 确认
application.properties或application.yml在src/main/resources下，且未被误放在test目录 - 检查占位符如
${redis.host}是否在所有激活的profile中都有定义（包括application-dev.yml和application.yml） - Spring Boot项目启动类确保在包的根路径（如
com.example.MyApp），避免组件扫描漏掉@Configuration类
排查Spring上下文初始化失败
BeanCreationException、UnsatisfiedDependencyException表示IoC容器构建失败。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- 看异常信息末尾的
Caused by:——它才是根本原因，比如数据库连接超时、Redis连不上、某个@Bean方法抛了NPE - 加
--debug参数启动（如java -jar app.jar --debug），Spring会输出自动配置的匹配/排除详情 - 临时注释掉可疑的
@Configuration类或@Bean方法，缩小范围；对数据库相关bean，可先配spring.datasource.url=jdbc:h2:mem:test快速验证
关注JVM参数与环境兼容性
UnsupportedClassVersionError、OutOfMemoryError或InvalidModuleDescriptorException常由运行环境不匹配引发。
- 检查
java -version与编译目标版本是否一致（如项目用maven-compiler-plugin设source=17，但运行时用JDK 8） - 查看启动脚本或IDE运行配置：堆内存是否过小（
-Xmx512m不够时加到-Xmx2g）、是否误加了已废弃参数（如-XX:MaxMetaspaceSize在JDK 17+可能不必要） - 模块化项目注意
module-info.java导出是否完整，第三方库是否声明了requires
基本上就这些。多数启动异常不是代码逻辑错，而是环境、配置、依赖这三块没对齐。养成先读栈顶Caused by、再查依赖树、最后看配置生效顺序的习惯，排查效率会高很多。
