宝塔面板安装Tomcat后Java项目无法运行，根本原因是JDK未正确配置、端口被占、WAR包未解压、Nginx未反向代理；必须手动设置JAVA_HOME、修正server.xml端口、建立setenv.sh并配置Nginx代理。
宝塔面板的“软件商店安装Tomcat”只是装了个裸容器，不等于 Java 环境就 ready 了——JDK 没配、端口被占、WAR 包不自动解压、Nginx 不转发，四个环节任一卡住，你的项目就 404 或 502。
为什么装完 Tomcat 还跑不起来 Java 项目
宝塔装的 tomcat 默认不检查 JAVA_HOME，也不写环境变量。你点“启动”，日志里大概率看到：Neither the JAVA_HOME nor the JRE_HOME environment variable is defined。它甚至可能用系统自带的 OpenJDK 11，而你的 WAR 是 JDK 17 编译的，直接抛 java.lang.UnsupportedClassVersionError。
常见现象包括：
- Tomcat 启动按钮点下去没反应，
ps -ef | grep tomcat查不到进程 - 能启动但访问
http://ip:8080显示 404，连 Tomcat 默认页都不出来 - 上传了
myapp.war到/www/server/tomcat/webapps/，目录里却没生成myapp/文件夹 - 宝塔“Java 项目”功能里填了 WAR 路径，点启动后提示成功，但
curl http://127.0.0.1:8080返回空或 connection refused
必须手动补全的三个配置点
别信“安装即可用”。装完 Tomcat 后，立刻 SSH 登录，按顺序执行以下三步：
立即学习“Java免费学习笔记（深入）”；
1. **确认并修正 JDK 路径**：
查看宝塔实际装的 JDK 位置：ls -l /www/server/java（常见路径）。如果为空或版本不对，别用宝塔自带的，去官网下 jdk-17.0.1_linux-x64_bin.tar.gz，解压到 /usr/lib/jvm/jdk-17.0.1，然后在 /etc/profile 末尾加：export JAVA_HOME=/usr/lib/jvm/jdk-17.0.1export PATH=$JAVA_HOME/bin:$PATH
再执行 source /etc/profile && java -version 验证。
2. **修正 Tomcat 的 JVM 启动参数**：
宝塔删掉了标准 setenv.sh，你要自己建：echo 'export JAVA_HOME=/usr/lib/jvm/jdk-17.0.1' > /www/server/tomcat/bin/setenv.shecho 'export JRE_HOME=$JAVA_HOME/jre' >> /www/server/tomcat/bin/setenv.shecho 'export CATALINA_OPTS="-Xms512M -Xmx1024M -server -XX:+UseG1GC"' >> /www/server/tomcat/bin/setenv.sh
3. **检查并释放 8080 端口**：
宝塔面板自身监听 8888，但它默认也会占用 8080（用于内部调试），导致 Tomcat 启动失败。
执行：netstat -tuln | grep :8080，如果看到 127.0.0.1:8080 被 nginx 或 bt 占用，就得改：
– 进宝塔【安全】→ 放行端口，删掉 8080（只留你真正要对外暴露的）
– 编辑 /www/server/tomcat/conf/server.xml，把 <Connector port="8080" 改成 port="8081"（或其他未被占用端口）
用 Nginx 反向代理替代“Java 项目”插件
宝塔的“Java 项目”管理器是伪功能：它用 java -jar 启独立进程，和 Tomcat 无关，也不支持 WAR 包、session 复制、JNDI 等标准 Java EE 特性。真要跑 WAR，必须走 Tomcat + Nginx 转发这条路。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
操作步骤：
- 在宝塔【网站】→【添加站点】，域名填好，根目录设为
/www/server/tomcat/webapps/（不是/www/wwwroot/） - 进该站点 → 【反向代理】→ 添加，目标 URL 填
http://127.0.0.1:8081/（端口跟你上一步改的一致） - 上传 WAR 包到
/www/server/tomcat/webapps/，重命名为ROOT.war（覆盖前删掉旧ROOT/目录） - 等 3~5 秒，Tomcat 自动解压；刷新域名即可访问
注意：context.xml 中若存在 antiResourceLocking="true"，会导致 WAR 解压失败且无报错，页面空白——删掉这行再试。
最易忽略的权限与防火墙细节
就算上面全对了，还可能栽在这两处：
– /www/server/tomcat/webapps/ 下的 WAR 包，如果用宝塔文件管理器上传，权限常是 root:root，但 Tomcat 进程以 www 用户运行，导致解压失败。解决：chown www:www /www/server/tomcat/webapps/*.war
– 宝塔【安全】里放行了 8081，但云厂商控制台（如阿里云安全组）没开，外网依然连不上。必须同步在控制台加一条入方向规则：端口范围 8081/8081，授权对象 0.0.0.0/0（或限定 IP）
Tomcat 的 WAR 自动部署机制很脆弱：它依赖文件系统 inotify 事件，而某些云盘或挂载方式会屏蔽这类事件，导致上传后不触发解压——这种问题查日志都难定位，只能换本地磁盘路径或加个 sleep 2 && touch /www/server/tomcat/webapps/ROOT.war 强制刷新。
