Hyperf批量修改测试需闭环验证数据基线、执行逻辑与断言，禁用DB复用，用SQLite或Docker MySQL隔离环境，手动事务控制替代DatabaseTransactions，显式生成DI容器，启用协程Hook，并通过多协程并发验证幂等性与安全性。
Hyperf 框架中测试批量修改功能模块，不能只靠 PHPUnit 跑通就认为 CI 环境已覆盖。关键在于：批量操作涉及数据库状态变更、事务边界、并发安全，而 CI 环境缺乏本地调试的“确定性”。必须把数据准备、执行逻辑、断言验证三者闭环嵌入流水线，且与真实部署环境对齐。
确保测试数据库隔离且每次清空
批量更新（如 UPDATE users SET status = ? WHERE id IN (?)）依赖准确的数据基线。CI 中若复用测试库或残留旧记录，断言极易误判。
- 在 phpunit.xml 或 tests/bootstrap.php 中禁用全局 DB 连接复用，改用内存 SQLite 或 Docker 化 MySQL 实例
- Functional 测试前强制重置：用 Db::truncate('users') 或事务回滚（推荐），避免 DROP/CREATE 开销
- 配置 config/test/db.php 的 host 为 mysql（Docker 内网服务名），而非 localhost
编写可复现的批量操作测试用例
不要只测“能跑”，要测“改得准、不越界、不漏行”。Hyperf 的 DatabaseTransactions trait 不适用于批量 UPDATE，需手动控制。
- 先插入固定样本数据（如 5 条用户记录），明确 ID 和初始 status
- 调用被测服务方法（例如 UserBatchService::updateStatusByIds($ids, $newStatus)）
- 直接查库断言：用 $this->assertSame(3, User::where('status', 'active')->count())，而非仅检查返回值
- 补充边界测试：传空数组、重复 ID、不存在的 ID，验证是否静默忽略或抛出预期异常
在 GitHub Actions 中注入真实执行上下文
Hyperf 的协程和 DI 容器在 CI 中易因启动路径错位导致 Yii::$app 为 null 类似问题（虽非 Yii，但原理相通）——实际是 Container 未正确加载或 ConfigProvider 未注册。
- 工作流开头显式运行 php bin/hyperf.php di:generate，确保容器定义就绪
- 测试命令使用 vendor/bin/phpunit --configuration phpunit.xml --testsuite functional，不混用 unit suite
- 添加环境变量 HYPERF_ENV=test 和 SWOOLE_HOOK=all，启用协程 Hook 避免 MySQL 异步调用阻塞
- 失败时加 --verbose --debug 输出完整堆栈，定位是 SQL 错误、连接超时，还是容器注入失败
验证批量逻辑的幂等性与并发安全性
批量修改常被用于定时任务或后台作业，CI 需模拟多请求并发场景，防止出现“双写覆盖”或“部分成功”问题。
- 用 Hyperf 的 Coroutine::create() 启动 3–5 个协程，同时调用同一批量更新接口
- 断言最终数据库中目标字段值完全一致（如全部变为 processed），且无主键冲突或死锁日志
- 若业务允许，可在测试中临时启用 DB::enableQueryLog() 捕获实际执行的 SQL，确认是否命中索引、是否拆分大批次
