Laravel插入jobs表触发SQLSTATE[23000] 1048非空约束报错

报错信息 #

SQLSTATE[23000]: Integrity constraint violation: 1048 Column 'job_description' cannot be null
对应执行SQL：insert into jobs (job_title, job_description, file, note) values (EEE, ?, user.JPG, KJL)
错误本质：jobs表的job_description字段设置了非空约束，但插入语句中该字段传入了null值。

现有代码说明 #

数据库迁移定义 #

Schema::create('jobs', function (Blueprint $table) {
    $table->id();
    $table->string('job_title');
    $table->string('job_description');
    $table->string('file');
    $table->string('note');
    $table->timestamps();
});

模型定义 #

use HasFactory;
protected $fillable = [
    'job_title',
    'job_description',
    'file',
    'note',
];

控制器插入逻辑 #

Job::insert([
    'job_title'=>$request->job_title,
    'job_description'=>$request->job_description,
    'file'=>$request->file,
    'note'=>$request->note
]);
return Redirect()->back()->with('success','Job added successfully');

排查解决步骤 #

• 校验前端请求参数是否正确传递
  先在插入逻辑前加dd($request->all())打印所有请求参数，确认提交的参数中存在job_description字段且值不为null。最常见的原因是前端表单对应输入框的name属性拼写错误，或者前端未做必填校验，用户提交空内容时后端直接拿到null值。
  修复方式：给后端接口加参数校验，从入口拦截非法空值：

  $validated = $request->validate([
      'job_title' => 'required|string',
      'job_description' => 'required|string',
      'file' => 'required|string',
      'note' => 'required|string',
  ]);
  

• 确认数据库实际表结构和迁移文件一致
  迁移文件中的字段定义不代表数据库实际结构：如果修改过迁移文件后没有重新执行迁移，或者之前的迁移执行失败，会导致数据库实际字段属性和代码定义不一致。可以直接连接数据库查看jobs表结构，确认job_description字段的非空属性是否符合预期。
  如果业务上允许该字段为空，新建迁移调整字段属性即可：
  1. 先安装依赖：composer require doctrine/dbal
  2. 编写字段修改迁移：

  Schema::table('jobs', function (Blueprint $table) {
      $table->string('job_description')->nullable()->change();
  });
  

  3. 执行迁移：php artisan migrate
• 替换insert()方法为模型的create()方法
  当前使用的Job::insert()是查询构造器的方法，会绕过模型的所有逻辑：既不会读取$fillable白名单做字段过滤，也不会处理字段类型转换、默认值逻辑，哪怕模型里做了字段预处理也不会生效。
  建议改用模型自带的create()方法，同时可以给可能为空的字段加兜底值：

  Job::create([
      'job_title' => $request->job_title,
      'job_description' => $request->job_description ?? '',
      'file' => $request->file,
      'note' => $request->note
  ]);
  

• 排查表名冲突问题
  Laravel框架自带的队列任务表默认表名就是jobs，如果项目开启了队列功能，自定义业务表和框架默认表重名，很容易出现表结构被后续队列迁移覆盖、数据插入错乱的问题。建议将自定义的业务岗位表重命名为job_positions等独立名称，从根源避免冲突。

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