本文介绍如何在 laravel 测试中，使用 factory sequence 为 postgresql 表预生成递增、非重复的 id 值，避免手动循环赋值，同时兼容 insert 和 insertmany 场景，确保测试数据符合生产环境的 id 分配逻辑。
本文介绍如何在 laravel 测试中，使用 factory sequence 为 postgresql 表预生成递增、非重复的 id 值，避免手动循环赋值，同时兼容 insert 和 insertmany 场景，确保测试数据符合生产环境的 id 分配逻辑。
在 Laravel 应用对接 PostgreSQL 时，若业务逻辑要求显式预留主键 ID（例如通过 nextval('users_id_seq') 获取序列值后再执行 INSERT），则单元测试中必须模拟这一行为——既不能跳过 ID 赋值（否则违反数据库约束），也不能复用同一 ID（否则 insertMany 测试将因主键冲突失败）。
你可能已尝试过以下方式：
// ❌ 错误：所有模型共享同一个 nextValId() 结果
$users = UserModel::factory(4)->make([
'id' => $this->userRepository->nextValId()
]);
或退而求其次，手动逐个赋值：
// ⚠️ 可行但冗余，难以维护且违背工厂设计初衷
$collection = UserModel::factory(4)->make()->toArray();
foreach ($collection as $i => &$user) {
$user['id'] = $this->userRepository->nextValId();
}
$this->userRepository->insertMany($collection);
真正的解决方案是 Laravel 内置的 Sequence 类——它专为解决“每个实例需独立计算属性”的场景而生，支持闭包动态生成值，并天然适配批量工厂调用。
✅ 推荐方案：使用 Sequence 动态生成唯一 ID
use Illuminate\Database\Eloquent\Factories\Sequence;
// ✅ 一行声明，自动为每个模型调用 nextValId()
$collection = UserModel::factory()
->count(4)
->state(new Sequence(
fn ($sequence) => ['id' => $this->userRepository->nextValId()]
))
->make();
$this->userRepository->insertMany($collection->toArray());
Sequence 的闭包会在每次创建一个模型实例时独立执行，因此 nextValId() 将被调用 4 次，返回 4 个真实、不重复的序列值。这完全匹配 PostgreSQL 生产环境的行为逻辑。
? 提示：若测试中无需真实数据库交互（如使用内存 SQLite 或 Mocked Repository），也可用轻量替代方案：
// 使用自增索引（适用于纯测试场景） new Sequence(fn ($seq) => ['id' => $seq->index + 1]) // 或结合 Faker 保证全局唯一性（注意：非严格有序） new Sequence(fn () => ['id' => $this->faker->unique()->numberBetween(1, 100000)])
⚠️ 注意事项与最佳实践
- 不要在 state() 中直接调用 $this->userRepository->nextValId()（无闭包包裹）：这会导致整个序列只执行一次，所有模型获得相同 ID。
- Sequence 仅在 make() / create() 时生效：确保你在调用 make() 前已正确链式调用 state()。
- 事务隔离很重要：若 nextValId() 实际查询数据库，请在测试类中启用 DatabaseTransactions 或 RefreshDatabase，防止序列值污染其他测试。
- 避免滥用 create()：正如问题所述，create() 会立即写入数据库，与“预留 ID 后插入”的业务逻辑冲突，应始终优先使用 make() + 显式 insert。
✅ 总结
Laravel 的 Sequence 是处理“批量模型需差异化动态属性”的标准答案。它让原本需要 5 行手动赋值的逻辑，压缩为一行可读、可复用、语义清晰的工厂声明。对于 PostgreSQL 序列驱动的 ID 管理策略，该方案不仅解决了 insertMany 测试难题，更使测试代码与生产逻辑高度对齐，显著提升可维护性与可靠性。
