java项目管理器仅支持springboot fat jar，需含meta-inf/manifest.mf且main-class正确；端口须在application.yml、宝塔设置、安全组及防火墙四层统一配置；jvm参数与spring boot运行参数均填入“jvm参数”框，环境变量单独填写。
Java项目管理器里上传的Jar包必须是可执行的SpringBoot Fat Jar
宝塔的Java项目管理器只认标准的SpringBoot打包方式：用spring-boot-maven-plugin打出来的fat jar，里面包含META-INF/MANIFEST.MF且Main-Class指向你的启动类。如果你用mvn package但没配插件，或者用了mvn clean compile + 手动jar，上传后会提示“无法识别为Java应用”。
验证方法：本地解压jar包，检查META-INF/MANIFEST.MF中是否含类似这行：Main-Class: com.example.MyApplication
- 打包命令建议用
mvn clean package -DskipTests - 确保
pom.xml里有spring-boot-maven-plugin且repackage目标已启用 - 不要上传war包或普通jar——Java项目管理器不支持
端口配置不能只改application.yml，还要在宝塔里放开防火墙和监听端口
即使你在application.yml里写了server.port: 8081，宝塔默认仍会尝试用8080启动，并且系统防火墙、宝塔面板自身的“安全”页、甚至云服务器厂商的安全组都可能拦掉新端口。
SpringBoot升级-BW
下载
将 Spring Boot 2.7 项目升级到 Spring Boot 3.5 的实战流程，覆盖版本基线、依赖坐标替换、Jakarta 迁移、配置兼容、异步上下文传递改造与验证门禁。用于企业多模块 Maven 项目升级与排障。
- 上传前，在
application.yml或application.properties里明确指定端口，例如：server.port=8081 - 上传后，在宝塔「Java项目管理器」对应项目的「设置」页，找到「运行端口」输入框，填
8081（必须和配置文件一致） - 去宝塔左侧「安全」→「放行端口」，添加
8081（TCP） - 如果是阿里云/腾讯云，还得登录控制台，在安全组规则里手动放行该端口
启动失败常见报错及对应检查点
点击「启动」后状态一直卡在“启动中”或秒退，日志里常出现这几类错误：
-
java.lang.UnsupportedClassVersionError→ JDK版本不匹配：宝塔Java项目管理器默认用JDK 8，而你用JDK 17编译了jar。进项目「设置」页，把「Java版本」改成匹配的（如jdk-17.0.1） -
Address already in use: bind→ 端口被占：用netstat -tuln | grep :8081查进程，或换一个端口重试 -
No main manifest attribute→ 不是fat jar，见第一个副标题 - 空日志或只有
Starting...就停住 → 检查jar是否依赖外部配置文件（如application-prod.yml），宝塔不会自动加载它们；把配置内联进application.yml，或用--spring.config.location参数传入绝对路径（需在「JVM参数」框里加）
JVM参数和环境变量要填在正确位置
宝塔Java项目管理器把JVM参数和环境变量分开处理，填错地方会导致配置无效。
- JVM参数（如内存限制、GC选项）填在「设置」页的「JVM参数」输入框，例如：
-Xms512m -Xmx1024m -XX:+UseG1GC - Spring Boot的运行时参数（如
--spring.profiles.active=prod）也得塞进这个框，不是「环境变量」栏 - 环境变量（如
MYSQL_HOST）才填在「环境变量」区域，每行一个KEY=VALUE格式 - 如果项目读取
application.yml里的${MYSQL_HOST}，那必须通过环境变量传进去，不能靠JVM参数
自定义端口这事看着简单，但实际卡点全在细节：jar是不是真能独立运行、端口有没有被层层拦截、JVM和Spring参数混着填反而失效——这些地方漏一个，服务就起不来。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
