API Platform 4.1 升级后测试失败的解决方案分析

2025-07-01 19:59:47作者：滕妙奇

在 API Platform 4.1 版本升级后，许多开发者遇到了测试套件失败的问题。本文将深入分析问题的根源，并提供完整的解决方案。

问题背景

API Platform 4.1 引入了一个重要的内部优化，改变了测试客户端的行为模式。这个变化主要影响了以下两种测试场景：

使用 RefreshDatabaseTrait 自动加载测试夹具的测试用例
在单个测试方法中执行多个请求的测试场景

核心问题分析

问题的根源在于 API Platform 4.1 对客户端创建机制的优化。在 4.1 版本之前，每次调用 createClient() 方法都会触发内核重启，这会导致：

数据库被完全重建
测试夹具重新加载
所有服务容器被重新初始化

4.1 版本通过 PR #6976 优化了这一行为，现在客户端创建不会自动重启内核，这带来了性能提升，但也破坏了部分现有测试的预期行为。

具体表现

开发者报告了两种主要的问题表现：

夹具加载失败：测试类继承自自定义的 AbstractApiTestCase，其中包含 setUp() 方法调用 self::bootKernel()，导致夹具无法正确加载。
多请求测试失败：在单个测试方法中执行多个请求时，第二个请求会意外失败（例如出现 JWT Token 未找到的错误）。

解决方案

针对夹具加载问题

修改测试基类的 setUp() 方法，使用静态调用：

public function setUp(): void
{
    static::bootKernel();  // 注意使用 static 而非 self
}

针对多请求测试问题

有两种可行的解决方案：

重用客户端实例：避免在测试中重复创建客户端，而是重用同一个实例。

public function testExample(): void
{
    $client = self::createClient();
    $user = /* 获取用户 */;
    $client->loginUser($user);
    
    // 第一个请求
    $client->request(/* ... */);
    
    // 第二个请求 - 使用同一个客户端
    $client->request(/* ... */);
}

强制内核重启：在需要时手动重启内核。

public function testExample(): void
{
    $client = self::createClient();
    // 第一个请求...
    
    // 强制重启内核
    static::$booted = false;
    $client = self::createClient();
    // 第二个请求...
}