本文介绍如何在 Laravel 测试中，使用 Factory Sequence 为 PostgreSQL 场景下需预分配主键（如通过 nextval() 获取）的批量插入操作，高效生成每个模型实例独立的 id，避免手动重复调用或硬编码，提升测试可维护性与可读性。
本文介绍如何在 laravel 测试中，使用 factory sequence 为 postgresql 场景下需预分配主键（如通过 `nextval()` 获取）的批量插入操作，高效生成每个模型实例独立的 `id`，避免手动重复调用或硬编码，提升测试可维护性与可读性。
在基于 PostgreSQL 的 Laravel 应用中，若业务逻辑要求在插入前显式获取并指定主键（例如通过 nextval('users_id_seq') 预留 ID），则单元测试中需确保每个待插入模型拥有真实、唯一、符合序列规则的 ID。此时直接使用 factory()->make([...]) 并传入静态 'id' => $this->userRepository->nextValId() 会导致所有模型共享同一 ID（因闭包外表达式仅执行一次），而逐个赋值（如 $users[0]['id'] = ...）虽可行，但冗长且违背 Laravel 工厂的设计哲学。
幸运的是，Laravel 自 v8.x 起原生支持 Factory Sequences —— 它允许你为每个生成的模型实例动态计算属性值，完美契合该场景。
✅ 推荐方案：使用 Sequence 动态生成唯一 ID
use Illuminate\Database\Eloquent\Factories\Sequence;
// 批量生成 4 个用户，每个 id 均调用 nextValId() 独立获取
$collection = UserModel::factory()
->count(4)
->state(new Sequence(
fn ($sequence) => ['id' => $this->userRepository->nextValId()]
))
->make();
$this->userRepository->insertMany($collection->toArray());
? Sequence 构造器接收一个闭包，该闭包对每个模型实例单独执行一次，参数 $sequence 提供 .index（从 0 开始）、.count 等元信息，因此你也可灵活实现其他策略（如模拟自增偏移）：
// 若测试环境支持重置序列，可用索引模拟：1, 2, 3, 4 fn ($seq) => ['id' => $seq->index + 1]
⚠️ 注意事项与最佳实践
- 避免在 state() 中使用共享状态：切勿将 $this->userRepository->nextValId() 提前赋值给变量再传入，否则仍会复用同一结果；
- 确保 nextValId() 在测试上下文中可用：若该方法依赖数据库连接，请确认测试使用 DatabaseTransactions 或 RefreshDatabase trait，且事务隔离不影响序列值获取；
- 不推荐 faker->unique()->randomNumber() 替代：虽然能生成唯一数字，但无法保证与 PostgreSQL 实际序列一致（如起始值、步长、并发安全性），可能掩盖序列冲突类 bug；
- 慎用 create()：如原文所述，factory()->create() 会直接写库，与“预留 ID 后由业务逻辑插入”的流程不符，易触发主键冲突，应严格避免。
✅ 总结
Sequence 是 Laravel 工厂处理“每实例差异化属性”的标准、优雅且可扩展的解决方案。它将原本需 5+ 行的手动赋值逻辑，浓缩为一行声明式代码，既保持测试的真实性（真正调用 nextval），又显著提升可读性与可维护性。对于涉及数据库序列、时间戳偏移、多版本标识等场景，Sequence 同样适用，值得纳入 Laravel 测试工具箱的核心技能。
