Symfony升级后PHPPdf序列化/反序列化测试问题排查与解决

临时解决办法 #

在测试类顶部添加PHPUnit注解，强制每个测试用独立进程执行：

/**
 * @runTestsInSeparateProcesses
 */

添加后测试可稳定通过，此前怀疑symfony/phpunit-bridge更新引发问题的判断并不准确。

问题详情 #

调试PHPPdf库时遇到序列化缓存反序列化失败的异常：

• 环境差异：Symfony 4.4的master分支运行正常，升级到Symfony 5.4的dev分支持续报错
• 待反序列化的原始负载：

  a:5:{s:8:"boundary";r:122;s:10:"attributes";a:4:{s:5:"width";s:3:"595";s:6:"height";s:3:"842";s:13:"margin-bottom";i:0;s:10:"margin-top";i:0;}s:19:"complexAttributeBag";a:0:{}s:15:"formattersNames";a:0:{}s:8:"priority";i:0;}
  

• 错误日志：

  request.CRITICAL: Uncaught PHP Exception PHPUnit\Framework\Error\Notice: "unserialize(): Error at offset 26 of 224 bytes" at vendor/littlerocket/php-pdf/lib/PHPPdf/Core/Node/Node.php line 1703 {"exception":"[object] (PHPUnit\Framework\Error\Notice(code: 8): unserialize(): Error at offset 26 of 224 bytes at vendor/littlerocket/php-pdf/lib/PHPPdf/Core/Node/Node.php:1703)"}
  

  错误位置集中在r:122（序列化引用标记）与s:10:"attributes"之间的偏移点。

核心代码片段 #

序列化与反序列化逻辑：

public function serialize()
{
    $data = $this->getDataForSerialize();

    $foo = serialize($data);

    $fooDeserialozed = unserialize($foo);

    return serialize($data);
}

public function unserialize($serialized)
{
    static::initializeTypeIfNecessary();

    $data = unserialize($serialized);

    $this->setDataFromUnserialize($data); // 原错误发生在此处：unserialize返回false，传入了要求数组的方法
}

protected function setDataFromUnserialize(array $data)
{
   // 业务逻辑实现
}

进一步调试建议 #

• 校验序列化数据一致性：在serialize()方法中，对比内存中的序列化结果$foo和缓存中最终存储的内容，排查Symfony 5.4缓存组件是否对数据做了截断、压缩或格式修改。
• 核对PHP版本差异：确认两个分支的PHP版本是否一致，不同版本的序列化机制（尤其是对象引用r:的处理）可能存在兼容性问题。
• 追踪引用对象生命周期：r:122对应序列化时的引用对象，检查Symfony 5.4环境中该对象是否在序列化完成前被销毁，导致反序列化时无法解析引用。
• 关闭缓存优化配置：临时禁用Symfony缓存的序列化优化（如自定义序列化器、数据压缩），直接存储原始序列化字符串，验证是否是缓存处理导致数据损坏。
• 添加反序列化错误日志：在unserialize()方法中捕获false返回值，记录完整的$serialized字符串，对比正常环境和异常环境的序列化内容，重点分析偏移26处的字符差异。
• 脱离测试环境验证：编写独立脚本测试序列化-存储-反序列化流程，确认是否是PHPUnit的进程共享状态导致引用失效。

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