金宇澄1. 复现现场：这个“找不到启动类”到底报了什么
你有没有过这种经历：本地 IDE 里点一下 Run，接口全通，页面正常，数据库读写都没毛病。等到准备发版，把项目传到云服务器，java -jar 按下去，几秒钟后控制台甩出一行冷冰冰的文字：
text复制错误: 找不到或无法加载主类 com.example.demo.DemoApplication
原因: java.lang.ClassNotFoundException: com.example.demo.DemoApplication
这一刻，很多人第一反应是“代码是不是传错了”“服务器上是不是少放了文件”“为什么本地没问题”。我直接说结论：这类问题九成以上不是业务代码的问题，而是构建产物、启动命令、运行环境三者之间的一致性出了问题。更扎心的是，本地“能跑”这件事，恰恰会掩盖真正的差异点。
1.1 两种典型报错，掩盖了不同的故障层
先分清楚你看到的到底属于哪种报错，因为修复方向完全不一样。
第一种是 JVM 启动时直接提示“找不到或无法加载主类”。这种报错发生在 main 方法还没执行之前，JVM 按照类名去 classpath 里扫描对应的 .class 文件，但一无所获。原因要么是类名/包名写错，要么是运行时 classpath 里根本没有那个类文件。
第二种是 Spring Boot 的 banner 已经打出来了，启动过程中突然来一段 Caused by: java.lang.NoClassDefFoundError，或者某个 ClassNotFoundException，里面又带着你自己的 DemoApplication。这种情况往往不是启动类丢失，而是某个运行时要加载的类不存在，只不过栈顶会先出现“启动类相关”的字样，容易让人误判成标题里的“找不到启动类”。
还有一个非常常见的兄弟错误：no main manifest attribute, in app.jar。它通常出现在你直接对普通 jar 执行 java -jar 时，因为 jar 包里的 META-INF/MANIFEST.MF 没有告诉 JVM “Main-Class 是谁”。
我把这几年遇到的现象整理成一张对照表，实际排查时可以对着看：
| 报错现象 | 真正问题方向 | 首选处理动作 |
|---|---|---|
错误: 找不到或无法加载主类 com.xxx.Application |
classpath 中缺失该类，或类名/包名不一致 | 先确认 jar 里是否存在该类，再检查启动类路径 |
no main manifest attribute |
打出来的不是 Spring Boot 可执行 fat jar | 检查 spring-boot-maven-plugin 的 repackage 配置 |
Caused by: java.lang.NoClassDefFoundError: org/springframework/boot/SpringApplication |
直接用 -cp 方式运行 fat jar，绕过 JarLauncher |
改用 java -jar 启动 |
java.lang.UnsupportedClassVersionError |
本地编译 JDK 版本高于服务器运行 JDK | 统一两侧 JDK 版本，或升级服务器 JRE |
1.2 先别改代码，先判断是不是这四类问题
遇到“本地没问题，服务器找不到启动类”，我建议先忍住打开源码改东西的冲动。先问自己四个问题：
第一，你上传到服务器的到底是个什么文件？是 mvn clean package 之后 target 目录里那个真正可运行的 jar，还是直接把整个项目文件夹压缩上传了？如果是后者，服务器上根本没有被正确编译好的产物，你后续所有启动操作都建立在“空气”上。
第二，你的启动命令是什么？很多人参考网上零散教程，习惯写 java -cp target/classes com.example.DemoApplication。这个命令在本地也许能跑，因为类文件真的就在 target/classes 里。但在服务器上，如果你没有执行过编译，或者在另一个目录下执行，target/classes 路径根本不存在，自然找不到主类。
第三，构建方式和本地运行方式是否一致？本地 IDE 点 Run 时，帮你干活的不一定是 Maven 的 package 流程。IDE 会做增量编译，自动拼接 classpath。而服务器上如果是从 Git 拉代码再执行构建，环境变量、JDK 版本、Maven 版本都可能不一样，结果可能差很远。
第四，服务器上运行的 Java 版本和本地编译版本是否一致？Class 文件有版本号，高版本 JDK 编译出的 class，低版本 JDK 无法加载。表现形式上可能不是温和的提示，而是在启动入口处直接抛 UnsupportedClassVersionError，日志又被截断成“找不到类”。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 为什么本地没问题：IDE 替你藏了多少事
很多人对“本地能跑 = 程序没问题”这个等式深信不疑。但部署环境里，本地验证通过只是必要不充分条件。你要先理解本地为什么能跑，才可能定位服务器上为什么不跑。
2.1 IDE 的 Run 按钮背后，classpath 是自动拼好的
以 IDEA 为例，你点 Run 的时候，它并不是执行 java -jar xxx.jar。IDEA