PHP从7.4升级至8.2后Javabridge-JDBC-PHP触发致命错误

问题重现 #

将PHP从7.4升级至8.2后，使用JasperReport的遗留Web应用触发致命错误：

Fatal error: Uncaught Error: Attempt to assign property "currentCacheKey" on null in http://servername:8080/JavaBridge/java/Java.inc:1999 Stack trace: #0 D:\xampp\htdocs\wip_live\javabridge.php(84): Java->__call('forName', Array) #1 {main} thrown in http://servername:8080/JavaBridge/java/Java.inc on line 1999

错误出在Java.inc的__call方法中对$client->currentCacheKey赋值的行，此时$client为null；触发点是PHP调用java.lang.Class->forName()的代码。

根本原因 #

1. PHP版本兼容性差异：PHP 8.0+将「对null赋值属性」从警告升级为致命错误，而PHP 7.4仅会抛出警告并继续执行，旧版JavaBridge未处理这种情况。
2. JavaBridge版本过旧：当前使用的JavaBridge版本不支持PHP 8.x，导致初始化$this->__client时失败，最终出现null值。

解决方案 #

方案1：升级JavaBridge到兼容PHP8.x的版本 #

• 下载适配PHP 8.x的最新PHP Java Bridge版本，替换现有JavaBridge目录下的文件
• 同步更新Java端的桥接服务（如果使用Tomcat部署的JavaBridge），确保两端版本匹配
• 测试验证报表生成功能是否恢复正常

方案2：临时修复Java.inc代码（应急方案） #

在Java.inc的错误行之前增加$client非空判断，避免致命错误：
找到出错的代码段：

} else {
    $client->currentCacheKey=$sig; //!!!this is where the code breaks!!!
    $retval=parent::__call($method,$args);
    return $retval;
}

修改为：

} else {
    if ($client !== null) {
        $client->currentCacheKey=$sig;
    }
    $retval=parent::__call($method,$args);
    return $retval;
}

• 此方案仅为临时应急，无法解决$client为null的根本问题，长期仍需升级JavaBridge

方案3：替换Java调用方式（长期重构方案） #

如果JavaBridge升级困难，可考虑重构代码：

• 将JasperReport报表生成逻辑封装为独立的Java REST接口，PHP通过HTTP请求调用生成PDF
• 避免直接使用PHP-Java桥接，降低版本兼容性风险

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