启用processIsolation后PHPUnit报PDO实例无法序列化/反序列化错误

这个问题的核心原因很明确：当你启用processIsolation="true"时，PHPUnit会在测试执行完毕后，尝试序列化测试类的整个实例，并将其状态传递回主进程。而你的测试类中持有了PDO实例（通过$this->db或者ClickController依赖链里的Database类），PDO对象本身是不支持序列化/反序列化的，所以就触发了这个致命错误。

你提到var_dump变量没问题，是因为var_dump是在隔离的测试进程内执行的，此时还没到PHPUnit序列化测试实例的环节——错误是在测试方法跑完、要把结果传回主进程时才发生的。

下面是几个可行的解决方案，按推荐程度排序：

1. 在tearDown()中清理不可序列化属性 #

最简单直接的办法，就是在每个测试结束后，把持有PDO的属性置为null，这样PHPUnit序列化时就不会处理它们了：

protected function tearDown(): void
{
    parent::tearDown();
    // 清理所有持有PDO或不可序列化对象的属性
    $this->db = null;
    $this->controller = null;
}

2. 禁用全局变量备份（针对Cookie操作场景） #

因为你操作了$_COOKIE全局变量，默认情况下PHPUnit会备份全局变量，在进程隔离模式下，这些备份的全局变量也会参与序列化。可以在测试方法或类上添加注解禁用备份，避免额外的序列化风险：

/**
 * @backupGlobals disabled
 */
public function testUserCookieIsSavedToClicksTable() {
    // ... 你的测试代码
}

3. 重构测试，避免在测试类实例中持有不可序列化对象 #

不要把$db这类包含PDO的对象作为测试类的属性，而是在测试方法内部创建和使用，用完就销毁：

public function testUserCookieIsSavedToClicksTable() {
    $cookie = sha1('12345');
    $_COOKIE['user_cookie'] = $cookie;
    $offerId = 1;
    $tx = $this->getTx($offerId);

    // 方法内部创建数据库实例，不保存到$this
    $db = new Database(Cache::getInstance());
    $controller = new ClickController(new Click($db, new Queue, new RedisStorage()));
    $this->runLocal([1, $this->userId], null);

    $sql = 'select * from clicks order by id desc limit 1';
    $click = $db->query($sql, [], 'fetch');
    $this->assertEquals($tx, $click['tx_id']);
    $this->assertEquals($click['user_cookie'], $cookie);

    // 手动清理
    $db = null;
    $controller = null;
}

4. 让测试类实现Serializable接口（复杂场景） #

如果你的测试类需要保留某些状态，但要排除不可序列化属性，可以实现Serializable接口，手动控制序列化的内容：

class YourTest extends PHPUnit\Framework\TestCase implements \Serializable
{
    private $db;
    private $userId;

    // ... 其他测试代码

    public function serialize()
    {
        // 只序列化需要保留的属性，排除$db
        return serialize(['userId' => $this->userId]);
    }

    public function unserialize($data)
    {
        $serializedData = unserialize($data);
        $this->userId = $serializedData['userId'];
        // 如果需要，可以在这里重新初始化$db等属性
    }
}

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