Laravel使用Factory填充数据报SQLSTATE[42S22]未知列description错误

你在Laravel项目中定义了如下ListingFactory用于生成测试数据：

<?php

namespace Database\Factories;

use Illuminate\Database\Eloquent\Factories\Factory;

class ListingFactory extends Factory
{
    /**
     * Define the model's default state.
     *
     * @return array
     */
    public function definition()
    {
        return [
              'title' => $this->faker->sentence(),
              'tags' => 'laravel, api, backend',
              'company' => $this->faker->company(),
              'email' => $this->faker->companyEmail(),
              'website' => $this->faker->url(),
              'location' => $this->faker->city(),
              'description' => $this->faker->paragraph(2)
        ];
    }
}

调用工厂向listings表插入数据时触发报错：

SQLSTATE[42S22]: Column not found: 1054 Unknown column 'description' in 'field list'
执行的SQL包含title、tags、company、location、email、website、description、updated_at、created_at字段，提示字段列表中不存在description字段。

• 直接打开数据库客户端，连接项目当前使用的数据库，查看listings表的实际字段列表，确认是否真的存在description字段，顺便核对.env里的数据库配置是否连对了目标库。
• 找到database/migrations目录下对应创建listings表的迁移文件，检查up()方法内的表结构定义，是否声明了description字段。
• 如果迁移文件里确实有description字段，执行php artisan migrate:status查看所有迁移的执行状态，确认对应迁移是不是没跑成功。

根据实际业务需求选对应处理方式：

1. 业务上不需要description字段
   直接打开ListingFactory.php，删掉definition方法里'description' => $this->faker->paragraph(2)这行定义即可。

2. 业务上需要description字段
   分两种场景处理：

• 本地开发环境、数据库无需要保留的重要数据：
  直接在原listings表创建迁移的Schema::create闭包中补充字段定义，示例：

  $table->text('description'); // 根据实际存储需求选字段类型，string/text/longText都可以
  

  然后执行命令重置迁移并重新填充数据：

  php artisan migrate:fresh --seed
  

• 已经执行过迁移、库内有不能删除的有效数据：
  新建迁移文件单独添加字段，执行命令生成迁移：

  php artisan make:migration add_description_to_listings_table --table=listings
  

  打开新生成的迁移文件，补充字段逻辑：

  public function up()
  {
      Schema::table('listings', function (Blueprint $table) {
          // 加nullable()兼容已存在的老数据，避免插入时非空约束报错
          $table->text('description')->nullable();
      });
  }
  
  public function down()
  {
      Schema::table('listings', function (Blueprint $table) {
          $table->dropColumn('description');
      });
  }
  

  执行迁移完成字段添加：

  php artisan migrate
  

如果开了配置缓存，执行操作前先跑php artisan config:clear清缓存，避免数据库连接配置不生效。处理完成后再调用工厂插入测试数据就不会触发该报错。

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