Laravel 9更新关联模型时出现完整性约束违反问题求助

我正在使用Laravel 9开发项目，编写了EmployeeController的updateEmployee方法，用于更新Employee、Title、Salary这三个一对多关联模型。但当尝试仅更新其中部分模型（比如只更新Employee和Salary）时，触发了SQLSTATE[23000]完整性约束违反错误，提示title字段不能为空。相关代码及错误信息如下：

相关代码 #

EmployeeController代码 #

public function updateEmployee(Request $request, $id)
{
    $employee = Employee::find($id);

    if (is_null($employee)) {
        return response()->json(['message' => 'Employee not found'], 404);
    }

    // Update employee information
    $employee->update([
        'first_name' => $request->input('first_name')
       ]);

    // Update related titles
    $employee->titles->update([
        'title' => $request->input('title')
       ]);

    // Update related salaries
    $employee->salaries->update([
        'salary' => $request->input('salary')
       ]);
return response($employee, 200);
}

API路由 #

Route::put('updateEmployee/{id}','App\Http\Controllers\EmployeeController@updateEmployee');

模型关联代码 #

Employee模型

public function titles(): HasMany
{
    return $this->hasMany(Title::class, 'emp_no');
}

public function salaries(): HasMany
{
    return $this->hasMany(Salary::class, 'emp_no');
}

Salary模型

public function employee(): BelongsTo
{
    return $this->belongsTo(Employee::class, 'emp_no');
}

Title模型

public function employee(): BelongsTo
{
    return $this->belongsTo(Employee::class, 'emp_no');
}

错误信息 #

Illuminate\Database\QueryException: SQLSTATE[23000]: Integrity constraint violation: 1048 Column 'title' cannot be null (SQL: update `titles` set `title` = ? where `titles`.`emp_no` = 10 and `titles`.`emp_no` is not null) in file F:\2023\code\2023\api\vendor\laravel\framework\src\Illuminate\Database\Connection.php on line 760

• 当仅更新部分模型时，请求中没有传入title参数，$request->input('title')返回null
• 代码中无条件执行$employee->titles->update(...)，强制将title字段设为null
• titles表的title字段设置了非空约束，数据库拒绝该操作，抛出完整性错误

方式一：按需更新关联模型 #

修改控制器代码，仅当请求包含对应参数时才执行关联模型的更新：

public function updateEmployee(Request $request, $id)
{
    $employee = Employee::find($id);

    if (is_null($employee)) {
        return response()->json(['message' => 'Employee not found'], 404);
    }

    // 更新Employee信息
    $employee->update([
        'first_name' => $request->input('first_name')
    ]);

    // 仅当请求存在title参数时更新Title
    if ($request->has('title')) {
        $employee->titles->update([
            'title' => $request->input('title')
        ]);
    }

    // 仅当请求存在salary参数时更新Salary
    if ($request->has('salary')) {
        $employee->salaries->update([
            'salary' => $request->input('salary')
        ]);
    }

    return response($employee, 200);
}

方式二：调整数据库字段约束（业务允许时） #

如果业务逻辑允许title字段为空，可以修改titles表的字段约束：

1. 创建修改表结构的迁移文件：

php artisan make:migration alter_title_column_in_titles_table

2. 在迁移文件中修改字段：

public function up()
{
    Schema::table('titles', function (Blueprint $table) {
        // 允许title字段为空
        $table->string('title')->nullable()->change();
        // 或者设置默认值（二选一）
        // $table->string('title')->default('默认头衔')->change();
    });
}

public function down()
{
    Schema::table('titles', function (Blueprint $table) {
        // 回滚操作，恢复非空约束
        $table->string('title')->nullable(false)->change();
        // 如果之前设置了默认值，回滚时去掉
        // $table->string('title')->default(null)->change();
    });
}

3. 执行迁移：

php artisan migrate

注意：生产环境修改表结构前请备份数据，避免意外。

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