本文介绍如何在 laravel 测试中使用模型工厂（model factory）批量创建假数据时，精准控制部分记录的字段值（如固定设置“usa”“uk”），其余字段保持随机，避免全量覆盖或手动重复创建。
本文介绍如何在 laravel 测试中使用模型工厂（model factory）批量创建假数据时，精准控制部分记录的字段值（如固定设置“usa”“uk”），其余字段保持随机，避免全量覆盖或手动重复创建。
在 Laravel 测试中，ModelFactory 是高效生成测试数据的核心工具。但当需要混合“特定值 + 随机值”时（例如：20 条国家记录中，第 1 条为 "UK"、第 2 条为 "USA"，其余自动填充随机名称），直接使用 ->create(['name' => 'USA']) 会导致全部 20 条记录都写入相同值，丧失数据多样性；而逐条 create() 又违背批量操作的简洁性与可维护性。
此时，Laravel 内置的 Sequence 类是最佳解决方案。它允许你按创建顺序（索引）动态返回不同的属性数组，实现高度可控的差异化填充。
✅ 正确用法示例（Laravel 8+，需引入 Illuminate\Database\Eloquent\Factories\Sequence）：
use Illuminate\Database\Eloquent\Factories\Sequence;
use App\Models\Country;
$countries = Country::factory()
->count(20)
->sequence(
fn ($index) => $index === 0 ? ['name' => 'UK'] : [],
fn ($index) => $index === 1 ? ['name' => 'USA'] : [],
fn ($index) => ['name' => fake()->country()] // 其余 18 条使用真实国家名（更语义化）
)
->create();? 提示：上述写法采用多个闭包函数依次匹配的方式，比嵌套三元运算更清晰、易扩展。Laravel 会按顺序尝试每个闭包，首个返回非空数组的即被采用；若均未命中，则回退至工厂默认行为（或报错，取决于配置）。
? 关键注意事项：
- sequence() 中的闭包接收 $index 参数（从 0 开始），请勿误用 $sequence 或 $this->faker（工厂实例中无此上下文）；
- 推荐使用 fake()->country() 而非 fake()->word()，以确保生成符合现实语义的国家名称（如 'France', 'Japan'），提升测试可信度；
- 若需更多定制（如指定 ID、时间戳、关联关系），可在对应闭包中一并返回，例如：['name' => 'Canada', 'code' => 'CA', 'created_at' => now()->subDays(5)]；
- sequence() 不影响其他字段——未显式指定的字段仍由工厂定义的 definition() 方法或默认 faker 规则生成。
? 进阶技巧：你还可以将 Sequence 与 state() 组合，实现条件化状态变更，或配合 afterCreating() 执行创建后逻辑（如同步索引、触发事件）。
总之，sequence() 是 Laravel 工厂中实现“结构化随机性”的关键能力。合理运用它，既能保证测试数据的真实性与覆盖度，又能精准锚定关键样本，让单元测试与 Feature 测试更加稳健、可读、可维护。
