不能启用「java项目管理器」插件，因其多年未更新、不接管jdk环境变量，会覆盖/etc/profile导致java -version报错、tomcat启动失败、war包不解压；应卸载该插件，改用软件商店安装匹配的jdk与tomcat（如jdk8配tomcat9），手动部署war并确保权限、server.xml配置及安全组放行正确。
宝塔面板里装 Java 环境，别依赖「Java项目管理器」插件——它多年未更新，对 JDK 1.8 兼容差，java -version 都可能报错，WAR 包部署后常卡在“解压中”或 404。直接用软件商店装 JDK + Tomcat，再手动放 WAR 包，是最稳的路径。
为什么不能开「Java项目管理器」插件
这个插件（v1.x）本质是为老旧 WAR + Tomcat 封装的简易界面，底层不接管 JDK 环境变量，也不校验 JAVA_HOME 是否真实生效。一旦启用，它会偷偷覆盖 /etc/profile 里的配置，导致：
-
javac命令失效，java -version显示 “not found” 或版本错乱 - Tomcat 启动日志里反复出现
Cannot find JAVA_HOME或UnsupportedClassVersionError - 上传 WAR 包后，
/www/server/tomcat/webapps/下只生成空目录，不自动解压
解决办法：安装完 JDK 和 Tomcat 后，**立刻在宝塔「软件管理」里卸载该插件**，别点“启用”。
用软件商店装 JDK 和 Tomcat 的关键匹配规则
宝塔软件商店里 JDK 和 Tomcat 是分开上架的，但它们不自动绑定。你得自己核对兼容性，否则 Tomcat 根本起不来：
- JDK 8（如
OpenJDK 8u402）→ 必须配Tomcat 8.5或Tomcat 9.0（Tomcat 10+默认要求 JDK 11+） - JDK 11/17 → 只能选
Tomcat 9或Tomcat 10，Tomcat 8.5会启动失败并报java.lang.NoClassDefFoundError: javax/servlet/Filter - 安装顺序必须是：先装 JDK，等状态显示「运行中」且
java -version正确，再装 Tomcat
验证方式：进宝塔终端，执行 ps aux | grep tomcat，若看到 -Djava.home=/www/server/java 路径，说明关联成功；若还是 /usr/lib/jvm 或空白，就是没绑上。
上传 WAR 包后不自动解压？检查这三处
把 myapp.war 拖进 /www/server/tomcat/webapps/ 后，等 30 秒没反应，不是网络慢，而是 Tomcat 拒绝处理：
-
webapps 目录权限不对：确保属主是
root或www，且权限为755，执行chown -R www:www /www/server/tomcat/webapps -
Tomcat 自动部署被关了：打开
/www/server/tomcat/conf/server.xml，找到<host></host>标签，确认里面有unpackWARs="true" autoDeploy="true" -
WAR 包名含大写字母或特殊符号：Tomcat 严格按文件名生成上下文路径，
MyApp.war会变成http://ip:8080/MyApp/，但某些版本对大小写敏感，建议统一用小写加短横线，如user-service.war
改完记得重启 Tomcat：在宝塔「软件管理」里点「重启」，别只点「重载配置」。
外网访问 404 或拒绝连接？不只是端口问题
即使 http://服务器IP:8080/ 能看到 Tomcat 欢迎页，你的 WAR 项目仍可能 404，原因常被忽略：
-
项目默认上下文路径不是根路径：
myapp.war解压后是/www/server/tomcat/webapps/myapp/，访问地址是http://IP:8080/myapp/，不是/；想改到根路径，得把 WAR 包重命名为ROOT.war（全大写，无扩展名） - 云厂商安全组没放行 8080，只开了宝塔面板的 8888：宝塔「安全」页面里放行端口只是系统防火墙，阿里云/腾讯云后台的安全组策略必须单独加一条 8080 入方向规则
-
Spring Boot 项目内置了 Tomcat，又套了一层外置 Tomcat：这种 WAR 包本质是“可执行 WAR”，不该丢进 webapps；应改用「Java项目」功能直接运行 JAR，或删掉
spring-boot-starter-tomcat依赖再打 WAR
最易漏的一点：宝塔「网站」列表里如果已存在同端口的 Nginx 站点，它会劫持 8080 流量，导致 Tomcat 实际监听了但收不到请求——删掉冲突站点或改 Tomcat 端口更干脆。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
