Tomcat部署JavaBridge.war启动失败，无法通过Php/Java Bridge运行PHP

一、先定位监听器启动失败的具体原因 #

Tomcat提示的“一个或多个监听器启动失败”是核心问题，必须先拿到详细错误信息：

• 打开Tomcat logs目录下的localhost.log（或带日期的localhost.xxxx-xx-xx.log），里面会有监听器启动失败的堆栈日志，能直接指出是类找不到、依赖缺失还是版本冲突。
• 最常见的原因是JavaBridge版本与Tomcat 10.x不兼容：Tomcat 10.x采用Jakarta EE规范，API包名从javax.*改为jakarta.*，旧版JavaBridge基于Java EE，会导致监听器类加载失败。

二、修复版本兼容性问题 #

针对Tomcat 10.x的适配方案：

• 直接下载支持Jakarta EE的JavaBridge版本，确保war包是专门为Tomcat 10及以上版本编译的。
• 若找不到适配包，可手动修改现有war包：
  1. 把JavaBridge.war解压到Tomcat的webapps/JavaBridge目录。
  2. 替换WEB-INF/lib下的Java EE相关JAR为Jakarta版本（比如将javax.servlet-api.jar换成jakarta.servlet-api.jar）。
  3. 检查WEB-INF/web.xml里的监听器配置，确保类路径对应的是Jakarta规范下的类（比如将javax.servlet.ServletContextListener改为jakarta.servlet.ServletContextListener）。

三、优化TLD扫描警告（可选） #

针对日志里的TLD扫描提示，要缩短启动时间可按以下操作：

• 编辑Tomcat conf/catalina.properties文件，找到tomcat.util.scan.StandardJarScanFilter.jarsToSkip属性，添加所有被扫描但无TLD的JAR文件名。如果不知道具体JAR，可开启调试日志：
  在conf/logging.properties里将org.apache.jasper.servlet.TldScanner的日志级别设为FINE，重启Tomcat后就能看到完整的无TLD JAR列表，再添加到跳过列表中。

四、修复访问页面仅显示图片的问题 #

启动成功后访问页面异常，说明PHP处理逻辑未生效：

• 检查JavaBridge的PHP路径配置：打开webapps/JavaBridge/WEB-INF/web.xml，找到php.java.bridge.php_exec参数，确保值是本地php-cgi的正确路径（Windows下是php-cgi.exe的绝对路径，Linux下是/usr/bin/php-cgi这类路径）。
• 验证php-cgi可用性：在命令行执行php-cgi -v，确保能正常输出版本信息，无报错。
• 检查权限：确保Tomcat进程有读取PHP安装目录及执行php-cgi的权限。

内容的提问来源于stack exchange，提问作者Muhammad Afshal