Laravel Factory定义字段未生效，创建数据报错如何解决？

以下是几个可能导致工厂定义字段未生效的原因及解决方法：

• 工厂类未绑定对应模型
  检查你的CategoryFactory类是否正确设置了$model属性，指定对应的模型类。如果缺少这个配置，Laravel无法将工厂和模型关联，定义的字段自然不会被应用。
  正确示例：

  namespace Database\Factories;
  
  use App\Models\Category;
  use Illuminate\Database\Eloquent\Factories\Factory;
  
  class CategoryFactory extends Factory
  {
      protected $model = Category::class; // 必须设置这一行
  
      public function definition()
      {
          return [
              'company_id' => 1,
              'name' => $this->faker->word(),
              'parent_id' => null,
          ];
      }
  }
  

• 模型批量赋值限制
  Laravel的模型默认有批量赋值保护，如果Category模型的$fillable数组没有包含company_id、name、parent_id，或者$guarded设置为['*']，工厂通过批量赋值写入字段时会被拦截，导致数据库报错。
  解决方法二选一：

  1. 将需要赋值的字段加入$fillable：

     namespace App\Models;
     
     use Illuminate\Database\Eloquent\Model;
     use Illuminate\Database\Eloquent\Factories\HasFactory;
     
     class Category extends Model
     {
         use HasFactory;
     
         protected $fillable = ['company_id', 'name', 'parent_id'];
     }
     

  2. 允许所有字段批量赋值（仅建议测试环境使用）：

     protected $guarded = [];
     

• 工厂definition方法存在语法错误
  检查definition方法的返回数组是否有语法问题，比如遗漏逗号、括号不匹配，导致返回的数组不完整，company_id字段没有被正确包含进去。确保返回的是结构完整的关联数组。

• 测试代码意外覆盖字段
  如果测试代码中调用create()时传入了覆盖参数，且无意中清空了company_id（比如传入['company_id' => null]），也会导致报错。检查测试代码中的create()调用是否有这类操作。

内容的提问来源于stack exchange，提问作者Tomas Lucena