Codeception分组测试顺序异常：API测试未先于验收测试执行

Codeception的分组（group）功能仅用于归类测试用例，不保证分组内测试的执行顺序——它会默认按suite定义顺序、文件名排序或其他内部规则执行，这就是你遇到验收测试先跑的原因。以下是几种可靠的解决方法：

方法1：使用依赖注解强制顺序 #

在验收测试的Cest类/方法上添加@dependsClass或@depends注解，明确声明依赖API测试的类或方法，Codeception会确保依赖的测试先执行。

示例：类级依赖 #

在tests/acceptance/MyAcceptanceTestCest.php中：

<?php
class MyAcceptanceTestCest
{
    /**
     * @dependsClass \Tests\Api\MyAPITestCest
     */
    public function runAcceptanceTest(AcceptanceTester $I)
    {
        // 验收测试逻辑
    }
}

示例：方法级依赖 #

如果仅依赖API测试中的特定方法：

<?php
class MyAcceptanceTestCest
{
    /**
     * @depends \Tests\Api\MyAPITestCest::createRequiredTestData
     */
    public function runAcceptanceTest(AcceptanceTester $I)
    {
        // 验收测试逻辑
    }
}

添加注解后，继续使用你原来的分组执行命令即可，Codeception会自动处理顺序。

方法2：拆分命令分步执行 #

放弃分组，分两次执行测试，用&&连接命令——只有前一步API测试执行成功（返回码为0），才会执行后续的验收测试，完全保证顺序。

修改后的执行命令（合并为一行）：

sudo docker-compose run -e ENVVARIABLE=abc.my.env.com tests vendor/bin/codecept run api MyAPITestCest -vvv && sudo docker-compose run -e ENVVARIABLE=abc.my.env.com tests vendor/bin/codecept run acceptance MyAcceptanceTestCest -vvv --html results.html

方法3：自定义测试执行顺序扩展（进阶） #

如果需要更复杂的顺序控制，可以编写Codeception扩展来自定义执行顺序，但这种方法适合有一定框架二次开发经验的场景，前两种方法已经能覆盖你的需求，优先推荐。

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