Debian12下Tomcat10部署Java11 Spring Boot WAR包问题排查

核心场景 #

将Debian11上基于Java11、Spring Boot 2.x的WAR包迁移至Debian12的Tomcat10环境，要求保留Java11、Spring-data-solr，不升级至Java17、Jakarta API、Spring Boot 3.x，仅更新Maven插件、Jacoco或切换com.mysql依赖。当前问题：本地构建的WAR包放入/var/lib/tomcat10/webapps-javaee后未自动解压，或解压后API端点无法访问；Maven构建100%成功，已通过alternatives设置系统默认Java11，Catalina主日志无异常。

可能遗漏的关键配置/操作 #

1. Tomcat10兼容目录的自动部署配置 #

Tomcat10的webapps-javaee是专为兼容javax API应用设计的目录，但需确认Tomcat是否启用该目录的自动部署：

• 检查/etc/tomcat10/server.xml中<Host>节点的appBase属性是否设置为webapps-javaee，默认可能为webapps（Jakarta EE目录）；
• 确认<Host>节点包含deployOnStartup="true"和autoDeploy="true"参数，确保Tomcat启动或WAR包放入时自动部署。

2. WAR包的依赖与打包正确性 #

• 确保Spring Boot打包时排除嵌入式Tomcat：检查pom.xml中spring-boot-starter-tomcat的scope设置为<scope>provided</scope>，避免与Tomcat10的容器依赖冲突；
• 验证WAR包依赖全为javax版本：禁止混入jakarta.servlet相关依赖，通过jar tf your-app.war | grep jakarta检查，若存在需排查Maven依赖传递并排除；
• 确认WAR包结构符合规范：WEB-INF目录下需包含web.xml（或Spring Boot的ServletInitializer实现类，确保Tomcat能识别应用入口）。

3. 文件权限问题 #

Debian12的Tomcat10默认以tomcat10用户运行，WAR包权限不正确会导致Tomcat无法读取：

• 执行ls -l /var/lib/tomcat10/webapps-javaee/your-app.war查看权限，确保所有者为tomcat10:tomcat10；
• 若权限不符，执行chown tomcat10:tomcat10 /var/lib/tomcat10/webapps-javaee/your-app.war修正。

4. Tomcat10的Java版本配置 #

即使系统alternatives设置了Java11，Tomcat可能单独配置了JAVA_HOME：

• 检查/etc/default/tomcat10文件，确认JAVA_HOME指向Java11路径（如/usr/lib/jvm/java-11-openjdk-amd64）；
• 若未设置，添加该配置后重启Tomcat服务：systemctl restart tomcat10。

无反馈场景的调试步骤 #

1. 查看全量Tomcat日志 #

除Catalina主日志外，检查以下日志文件：

• /var/log/tomcat10/localhost.log：记录应用启动时的详细错误；
• /var/log/tomcat10/localhost_access_log.*.txt：查看是否有请求到达Tomcat；
• /var/lib/tomcat10/webapps-javaee/your-app/WEB-INF/logs（若存在）：应用自身的日志文件。

2. 手动验证部署流程 #

• 手动解压WAR包：执行unzip your-app.war -d /var/lib/tomcat10/webapps-javaee/your-app，修改目录权限为tomcat10:tomcat10后重启Tomcat，观察是否能识别应用；
• 启用Tomcat管理控制台：在/etc/tomcat10/tomcat-users.xml中添加管理员权限，重启后通过控制台手动上传WAR包，查看部署时的错误提示。

3. 验证Tomcat运行时的Java版本 #

• 查看Tomcat进程参数：ps aux | grep tomcat10，确认启动参数中-java-home指向Java11；
• 执行Tomcat版本脚本：cd /usr/share/tomcat10/bin && ./version.sh，输出中需显示Java版本为11.x。

4. 检查Tomcat部署状态文件 #

查看Tomcat工作目录下的应用上下文配置：/var/lib/tomcat10/work/Catalina/localhost/your-app.xml，若该文件不存在，说明Tomcat未识别到有效WAR包；若存在，检查文件内容是否有配置错误。

5. 测试最简兼容WAR包 #

创建一个仅包含javax.servlet的最简WAR包（如一个HelloWorld Servlet+web.xml），放入webapps-javaee目录，验证环境本身是否支持javax应用部署，排除环境层面的问题。

内容的提问来源于stack exchange，提问作者Eamonn Kenny