本文介绍如何在 Laravel 测试中使用 Factory Sequence 为 PostgreSQL 预留 ID 场景下的批量插入（如 insertMany）高效生成互不重复的主键值，避免手动赋值或硬编码，提升测试可维护性与可读性。
本文介绍如何在 laravel 测试中使用 factory sequence 为 postgresql 预留 id 场景下的批量插入（如 `insertmany`）高效生成互不重复的主键值，避免手动赋值或硬编码，提升测试可维护性与可读性。
在基于 PostgreSQL 的 Laravel 应用中，若业务逻辑要求插入前显式调用 nextval('table_id_seq') 预留主键 ID（而非依赖数据库自增或 Eloquent 的自动 ID 分配），则单元测试中需确保每个待插入模型拥有独立、确定、非冲突的 ID。此时，直接在 factory()->make() 的属性数组中静态指定 'id' => $this->userRepository->nextValId() 会导致所有模型共享同一 ID（因该表达式仅执行一次），从而在 insertMany 测试中引发主键冲突或逻辑错误。
Laravel 自 8.x 起提供的 Factory Sequence 是解决此问题的理想方案。它允许你为工厂生成的每个模型实例动态计算属性值，且天然支持闭包回调，在每次实例化时独立执行——完美契合 nextval() 的逐条调用需求。
以下为推荐实现方式：
use Illuminate\Database\Eloquent\Factories\Sequence;
// ✅ 正确：每个模型调用 nextValId() 一次，获得唯一 ID
$collection = UserModel::factory()
->count(4)
->state(new Sequence(
fn ($sequence) => ['id' => $this->userRepository->nextValId()]
))
->make();
$this->userRepository->insertMany($collection->toArray());
? Sequence 中的闭包接收 $sequence 对象，其 ->index 属性从 0 开始递增，可用于构造顺序 ID（如 ['id' => $sequence->index + 1]），但注意：这仅适用于模拟场景；真实 PostgreSQL 序列必须通过 nextval() 获取，以确保与生产逻辑一致。
⚠️ 关键注意事项
- 勿混用 create()：如问题所述，factory()->create() 会直接写入数据库，导致后续 insertMany 因主键已存在而失败。make() + 显式 ID 赋值是唯一安全路径。
- 事务隔离保障：建议在测试类中启用 DatabaseTransactions trait，确保 nextValId() 调用不影响其他测试用例的序列状态（PostgreSQL 序列值不可回滚，但测试 DB 通常为独立实例或每次重建）。
- 性能考量：若 nextValId() 内部涉及数据库查询，批量调用 100+ 次可能影响测试速度。此时可考虑在测试前预取范围 ID（如 pg_get_serial_sequence + nextval 批量调用），再通过 Sequence 分配，但需自行保证原子性与顺序性。
- 可复现性：若需完全 deterministic 测试（如断言特定 ID 值），应避免依赖实时 nextval()，改用 Sequence 结合固定偏移量（例如 fn($s) => ['id' => 1000 + $s->index]），并在测试文档中明确说明该 ID 仅为占位逻辑。
✅ 总结
Factory Sequence 不仅是一行替代方案，更是 Laravel 测试现代化的关键能力之一。它将“为每个模型生成差异化属性”这一常见需求封装为声明式、可组合、易复用的抽象，彻底取代了冗长的手动索引赋值循环。对于 PostgreSQL 序列驱动 ID 的项目，它既是最佳实践，也是保持测试简洁性与生产一致性之间的关键桥梁。
