Laravel 9更新数组字段正常，直接插入却报数组转字符串错误

场景概述 #

使用Laravel 9操作holes表时，前端提交对象数组更新空的hole_data字段完全正常，但直接插入包含该数组的记录时，会触发Array to string conversion错误；而先插入其他字段获取ID，再更新hole_data的方式却能成功执行。

正常更新的代码示例 #

前端JS代码 #

data = {
   id:1,
   name:'A Name',
   hole_data: [{…}, {…}]
}

await axiosClient.post('/updateholedata', data);

Laravel后端代码 #

public function updateHoleData(Request $request) {
   DB::table('holes')
   ->where('id', $request->id)
   ->update(['hole_data' => $request->hole_data]);              
   return $this->index();
}

直接插入报错的代码示例 #

前端JS代码 #

await axiosClient.post('/addholedata', data);

Laravel后端代码 #

public function addHoleData(Request $request) {
   $id = DB::table('holes')->insertGetId (['hole_data' => $request->hole_data]);
   return $id;
}

先插再更新正常的代码示例 #

public function addHoleData(Request $request) {
   $id = DB::table('holes')->insertGetId (['name' => $request->name]); // 先插入获取ID

   DB::table('holes')
   ->where('id', $id) // 用ID更新hole_data
   ->update(['hole_data' => $request->hole_data]);
}

问题原因 #

Laravel的update()和insertGetId()方法在处理数组类型字段时，内部逻辑存在差异：

• 执行update()时，Laravel会自动检测数据库字段类型，如果hole_data是json/jsonb类型，它会自动把数组序列化成JSON字符串再存入数据库。
• 但用insertGetId()直接插入时，Laravel不会自动做数组序列化操作，会直接尝试把数组当作字符串插入，因此触发了数组转字符串的错误。

解决方法 #

方法1：手动序列化数组 #

插入时直接将数组转为JSON字符串：

public function addHoleData(Request $request) {
   $id = DB::table('holes')->insertGetId([
       'name' => $request->name,
       'hole_data' => json_encode($request->hole_data)
   ]);
   return $id;
}

方法2：使用Eloquent模型（更推荐） #

定义Hole模型并设置字段类型转换，Eloquent会自动处理序列化/反序列化：

// app/Models/Hole.php
class Hole extends Model {
    protected $fillable = ['name', 'hole_data'];
    protected $casts = [
        'hole_data' => 'array' // 指定字段自动在数组与JSON间转换
    ];
}

// 后端控制器代码
public function addHoleData(Request $request) {
   $hole = Hole::create($request->only(['name', 'hole_data']));
   return $hole->id;
}

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