Laravel 10创建hasMany关联模型时出现‘Array to string conversion’错误

错误根源 #

你遇到的Array to string conversion错误，是因为Laravel 10中hasMany关联方法的foreignKey参数严格要求为字符串类型，但你传入了数组['session_id', 'branch_id', 'strukno']，触发了数组转字符串的类型转换错误。

Laravel 9 vs 10的关联语法差异 #

• Laravel 9对关联方法的参数类型校验较宽松，允许通过传入数组作为外键参数实现复合键关联；
• Laravel 10严格遵循方法定义的参数类型规范，hasMany的foreignKey仅支持单个字符串外键，不再接受数组参数。

正确的复合键关联写法 #

1. 修改Pos模型的details关联（hasMany） #

通过链式调用where方法添加多字段关联条件：

/**
 * Get all of the details for the Pos
 *
 * @return \Illuminate\Database\Eloquent\Relations\HasMany
 */
public function details(): HasMany
{
    return $this->hasMany(PosDetail::class)
        ->where('session_id', $this->session_id)
        ->where('branch_id', $this->branch_id)
        ->where('strukno', $this->strukno);
}

2. 修改PosDetail模型的pos关联（belongsTo） #

使用whereColumn方法批量匹配多列关联关系，确保逻辑正确：

/**
 * Get the pos that owns the PosDetail
 *
 * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
 */
public function pos(): BelongsTo
{
    return $this->belongsTo(Pos::class)
        ->whereColumn([
            'pos.session_id' => 'pos_details.session_id',
            'pos.branch_id' => 'pos_details.branch_id',
            'pos.strukdate' => 'pos_details.strukdate',
            'pos.strukno' => 'pos_details.strukno',
        ]);
}

修改后执行Pos::all()即可正常获取数据，该写法同时兼容Laravel 9和10版本。

内容的提问来源于stack exchange，提问作者Muhammad Ilham Shobirin