本文介绍如何在 Laravel 测试中，利用 Factory Sequences 为 PostgreSQL 预留 ID 场景下的批量插入（如 insertMany）高效生成互不重复的主键值，避免手动赋值冗余代码，提升测试可维护性与表达力。
本文介绍如何在 laravel 测试中，利用 factory sequences 为 postgresql 预留 id 场景下的批量插入（如 `insertmany`）高效生成互不重复的主键值，避免手动赋值冗余代码，提升测试可维护性与表达力。
在使用 PostgreSQL 作为底层数据库的 Laravel 应用中，若业务逻辑要求显式管理主键 ID（例如通过 nextval('users_id_seq') 预先获取序列值再执行插入），则单元测试中模拟该行为需确保每个待插入模型拥有唯一、符合数据库序列预期的 ID。传统方式如 UserModel::factory(4)->make() 配合静态数组赋值（如 'id' => $this->userRepository->nextValId()）会导致所有模型获得相同 ID，违反唯一性约束；而逐个手动修改数组元素（$users[0]['id'] = ...）虽可行，但缺乏扩展性与可读性。
Laravel 自 v8.52+（文档正式完善于 v9.x）提供的 Factory Sequences 正是解决此类问题的理想方案。它允许你在工厂构建过程中，为每个生成的模型实例执行独立回调，从而动态计算字段值——完美契合 nextval() 需逐次调用的语义。
✅ 推荐写法（一行声明，语义清晰）：
use Illuminate\Database\Eloquent\Factories\Sequence;
$collection = UserModel::factory()
->count(4)
->state(new Sequence(
fn ($sequence) => ['id' => $this->userRepository->nextValId()]
))
->make();
$this->userRepository->insertMany($collection->toArray());在此示例中：
- ->count(4) 指定生成 4 个模型实例；
- new Sequence(...) 为每个实例触发一次闭包，$sequence 对象提供上下文（含 ->index 等属性）；
- 闭包内调用 $this->userRepository->nextValId() 将被独立执行 4 次，确保每次获取真实递增的序列值；
- ->make() 仅构建内存对象，不触碰数据库，完全满足“仅测试插入逻辑，不污染数据”的要求。
? 进阶提示：
- 若测试环境已启用 DatabaseTransactions 或 RefreshDatabase，且序列起始值可控，也可用轻量替代方案：fn ($sequence) => ['id' => $sequence->index + 1]，适用于无需真实 nextval 的隔离测试场景；
- 序列支持链式组合，例如同时处理 id 和 created_at：new Sequence(['id' => ...], ['created_at' => ...])；
- 切勿在 state() 中使用共享变量或静态计数器——这会破坏并发安全性和测试隔离性，Sequences 的设计正是为了规避此类陷阱。
总结：面对 PostgreSQL 显式 ID 管理的测试需求，Factory Sequences 是 Laravel 官方推荐、语义明确、可复用性强的一等公民解决方案。它将原本易错、难维护的手动循环赋值，转化为声明式、单行、高内聚的工厂配置，显著提升测试代码质量与长期可维护性。
