Laravel User Factory配置：自动为创建用户分配Admin角色

问题背景 #

我拥有user和roles两张数据表：

• user表包含id、name、age等字段
• roles表包含id、user_id、role_name字段

User模型与Role模型为hasMany关联关系（一个用户对应多个角色），现在需要创建User Factory，实现创建用户时自动为其分配Admin角色。

实现代码 #

修改UserFactory.php如下：

<?php

namespace Database\Factories;

use App\Models\User;
use App\Models\Role;
use Illuminate\Database\Eloquent\Factories\Factory;
use Illuminate\Support\Str;

class UserFactory extends Factory
{
    protected $model = User::class;

    public function definition(): array
    {
        return [
            'name' => fake()->name(),
            'email' => fake()->unique()->safeEmail(),
            'email_verified_at' => now(),
            'password' => '$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKoEa3Ro9llC/.og/at2.uheWG/igi', // password
            'remember_token' => Str::random(10),
        ];
    }

    /**
     * 标记用户邮箱未验证
     */
    public function unverified(): static
    {
        return $this->state(fn (array $attributes) => [
            'email_verified_at' => null,
        ]);
    }

    public function configure()
    {
        return $this->afterCreating(function (User $user) {
            // 为用户创建并关联Admin角色
            $user->roles()->create([
                'role_name' => 'Admin'
            ]);
        });
    }
}

关键说明 #

1. 关联逻辑修正：因为User与Role是hasMany一对多关联，无需使用attach()方法（该方法用于多对多关联的中间表操作），直接通过$user->roles()->create()即可创建并自动绑定用户ID到roles表的user_id字段。
2. 指定Admin角色：在创建角色时直接指定role_name为Admin，确保每次创建用户都会分配该角色。
3. 回调时机：使用afterCreating回调，确保用户数据写入数据库后再创建关联角色，避免因用户未持久化导致的关联失败。

内容的提问来源于stack exchange，提问作者Kyeyune Daniel