PHPUnit跨测试类复用测试返回值 解决@depends顺序错乱问题

@depends 注解的设计初衷是解决同一测试类内的测试方法依赖传值问题，本身就没有对跨测试类的依赖场景做稳定支持：

• 跨类使用时不会自动保证依赖方法的执行优先级，很容易出现下游测试先跑、拿不到传值的问题
• 传值逻辑和测试执行顺序强绑定，只要单独运行某个下游测试方法/类，就会因为缺少前置依赖直接报错
• 多依赖场景下需要维护一长串注解链，代码可读性极差，改一个上游方法就会牵连所有下游用例

单元测试的核心原则是每个用例都应该独立可运行，不要靠其他测试方法的执行结果当输入。正确的做法是把通用测试数据的初始化逻辑抽到统一的测试基类setUp()流程中，所有需要用到测试客户ID的类直接复用初始化好的固定值即可。

具体实现步骤 #

• 先创建所有Repository测试类继承的基类，统一处理测试库重置、通用测试数据生成逻辑：

abstract class BaseRepositoryTestCase extends TestCase
{
    protected int $testCustomerId;
    protected CustomerRepository $customerRepository;
    protected AddressRepository $addressRepository;

    protected function setUp(): void
    {
        parent::setUp();
        // 初始化仓储实例
        $this->customerRepository = new CustomerRepository();
        $this->addressRepository = new AddressRepository();
        // 每次执行测试前重置测试库状态，避免脏数据干扰
        $this->resetTestDb();
        // 提前插入通用测试客户，拿到固定自增ID
        $this->testCustomerId = $this->customerRepository->insertNewUser(
            'testuser@test.com',
            'testpass123',
            'test',
            'user'
        );
    }

    protected function resetTestDb(): void
    {
        $this->dropData('address');
        $this->dropData('customer');
    }

    protected function dropData(string $tableName): void
    {
        // 原有清空表数据的逻辑
    }
}

• 改造原有测试类，移除跨类@depends注解，直接使用基类初始化好的测试ID：
  CustomerRepositoryTest.php 只需要关注插入逻辑本身的断言，不需要再给其他类传值：

class CustomerRepositoryTest extends BaseRepositoryTestCase
{
    public function testInsertNewCustomer(): void
    {
        $newCustomerId = $this->customerRepository->insertNewUser(
            'newuser@test.com',
            'newpass123',
            'new',
            'user'
        );

        $this->assertIsInt($newCustomerId);
        $this->assertGreaterThan(0, $newCustomerId);
        $this->assertNotEquals($this->testCustomerId, $newCustomerId);
    }
}

AddressRepositoryTest.php 直接调用基类属性里的客户ID，完全不依赖其他测试类的执行：

class AddressRepositoryTest extends BaseRepositoryTestCase
{
    public function testInsertNewAddress(): void
    {
        $insertAddressId = $this->addressRepository->insertNewAddress(
            $this->testCustomerId,
            'Test Street',
            'Test',
            22222,
            'Test',
            'billing'
        );

        $this->assertIsInt($insertAddressId);
        $this->assertGreaterThan(0, $insertAddressId);
        $this->assertNotFalse($insertAddressId);
    }
}

方案优势 #

• 所有测试用例完全独立，单独运行任何一个类、任何一个方法都能正常执行，不依赖执行顺序
• 通用测试数据逻辑统一维护，不会出现上游测试改了数据格式导致下游全部报错的问题
• 没有多余的依赖注解，代码结构清晰，后续需要新增其他复用数据（比如测试地址ID、测试订单ID）只需要在基类加属性即可，适配多值复用场景没有额外成本

如果暂时不想重构现有测试结构，可以用测试全局静态存储的方式传值，同时在phpunit.xml中手动指定测试类的执行顺序，把生成数据的测试类放在前面：

1. 新增测试上下文存储类

class TestGlobalContext
{
    public static array $pool = [];
}

2. 生产数据的测试方法执行后把ID存入静态池

public function testInsertNewCustomer(): int
{
    $newCustomer = $this->customerRepository->insertNewUser('testuser@test.com', 'password', 'test', 'user');
    // 原有断言逻辑不变
    TestGlobalContext::$pool['test_customer_id'] = $newCustomer;
    return $newCustomer;
}

3. 下游测试直接从静态池取值

public function testInsertNewAddress(): void
{
    $newCustomerId = TestGlobalContext::$pool['test_customer_id'];
    // 原有插入地址、断言逻辑不变
}

注意：该方案本质还是依赖测试执行顺序，并行测试场景下会直接失效，仅适合临时快速修复问题。

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