Codeception配置需按Yii版本区分：Yii2用Yii2模块配test.php入口文件，Yii3用Yii3模块配config/test/web.php；unit测试须显式启用模块，数据库用独立库+truncate或事务回滚，acceptance需关CSRF、设hostInfo、调优ChromeDriver。
Codeception 配置文件怎么写才不报错
Yii 应用的测试环境跑不起来，八成卡在 codeception.yml 或 tests/unit.suite.yml 的路径和模块配置上。Yii 2 和 Yii 3 的目录结构、自动加载机制不同，直接套模板大概率出 Class not found 或 Application not bootstrapped 错误。
实操建议：
- 确保
codeception.yml中的paths: tests:指向真实存在的tests/目录（不是tests/unit/） - Yii 2 项目必须启用
Yii2模块，并正确设置configFile——它得是应用入口的配置（如tests/_config/test.php），且该文件里要返回一个完整可运行的yii\web\Application实例 - Yii 3 项目改用
Yii3模块，configFile必须是config/test/web.php这类能被yii\di\Container加载的配置，不能是旧式require入口文件 - 别在
tests/_bootstrap.php里手动requireYii 自动加载器——Codeception 的Yii2/Yii3模块已接管，重复加载会导致Cannot redeclare class
测试里访问 Yii 容器和数据库为什么总是 null
写完测试用例，调 Yii::$app 返回 null，或 $this->tester->grabRecord() 报 Connection is not established，本质是测试环境没真正启动 Yii 应用上下文。
实操建议：
- 单元测试（unit）默认不加载 Yii 模块，必须显式在
tests/unit.suite.yml中启用Yii2或Yii3模块，且depends: functional是无效的——unit 不继承 functional 的模块 - 数据库连接失败，先确认
config/test/db.php是否存在并返回有效yii\db\Connection实例；再检查tests/_config/test.php是否把该 db 配置 merge 进了应用组件 - 使用
$I->amOnPage()前必须跑 functional 或 acceptance 测试——unit suite 里调这个会直接抛异常，不是 bug，是设计如此 - 若需在 unit 测试中模拟 DB 行为，用
Stub::make或Mockery::mock替换ActiveRecord类，别硬连测试库
acceptance 测试打开浏览器就卡住或白屏
用 PhpBrowser 或 WebDriver 跑 acceptance，页面加载后没反应、JS 不执行、表单提交无反馈，常见于 Yii 的 CSRF 验证、AssetBundle 路径或 URL 规则未适配测试域名。
实操建议：
- 关闭 CSRF 验证：在
tests/_config/test.php的request组件中加'enableCsrfValidation' => false，否则表单提交永远 400 - 确保
urlManager的hostInfo设置为测试用地址（如'http://localhost:8080'），否则生成的链接是http://localhost/xxx，而 PhpBrowser 实际请求的是http://127.0.0.1/xxx，触发跨域或重定向失败 - AssetBundle 发布路径错乱？在测试配置里强制指定
'basePath' => '@tests/_output/assets'，并确保该目录可写 - WebDriver 启动慢？别用 ChromeDriver 默认配置，在
tests/acceptance.suite.yml的WebDriver模块下加capabilities: {'goog:chromeOptions': {'args': ['--no-sandbox', '--disable-gpu']}}
测试数据库清不干净，用例之间互相污染
一个 test 方法里插入数据，下一个 test 就查到上一条记录，或者 migration 回滚失败导致 SQLSTATE[42S01]，说明测试数据库隔离没做对。
实操建议：
- 别依赖全局
Db模块的cleanup: true——它只清表，不删库，也不处理外键约束。Yii 测试推荐用yii\test\DatabaseTestCase（Yii 2）或yii\tests\TestCase（Yii 3）基类，它们自带事务回滚 - functional 和 acceptance 测试无法用事务回滚？那就用独立测试库 + 每次测试前
db:truncate，通过Codeception\Lib\Module\Db::clean()手动触发，而不是靠模块自动清理 - Migration 在测试中执行失败？确认
tests/_config/test.php的controllerMap包含'migrate' => 'yii\console\controllers\MigrateController'，且db组件指向测试专用数据库 - 使用 SQLite 内存数据库（
sqlite::memory:）仅限 unit 测试——functional/acceptance 无法共享内存实例，每个请求都会新建连接，数据自然不一致
最麻烦的其实是 Yii 3 的 DI 容器缓存和事件监听器残留，跑完测试记得调 \Yii::getContainer()->set('db', null) 清掉单例，否则下次测试可能拿到旧连接。
