Laravel 使用hasManyThrough实现三层嵌套关联时报SQL字段不存在错误

问题根因 #

你的关联逻辑存在多处参数错误、关联类型错误、命名不匹配问题，核心报错来自hasManyThrough方法的参数完全不符合Laravel的语法要求。

具体错误点：

1. hasManyThrough参数逻辑错误：Laravel的hasManyThrough第一个参数是最终要获取的目标模型，第二个是中间过渡模型，你错误的把两个参数都填成了MeasurementField::class，中间模型实际应该是MeasurementData::class，且后续外键参数顺序也完全错位。
2. 各模型关联的类型、命名、关联对象不匹配：
   • Measurement模型中返回MeasurementData关联的方法命名为measurement_field，和实际返回的模型完全不对应
   • MeasurementData模型中本应关联MeasurementField的方法，错误关联到了MeasurementType，且关联类型写反
   • MeasurementField模型的关联类型写反，且关联对象错误
3. 控制器预加载的关联名和模型中定义的方法名不匹配。

修复代码 #

1. Measurement 模型

public function clients() {
    return $this->belongsTo(Client::class, 'client_id');
}

// 关联中间表measurement_data
public function measurement_datas() {
    return $this->hasMany(MeasurementData::class, 'measurement_id');
}

// 正确的hasManyThrough关联，直接获取测量项对应的所有字段配置
public function measurement_fields() {
    return $this->hasManyThrough(
        MeasurementField::class, // 最终要获取的字段模型
        MeasurementData::class, // 中间过渡的测量数据模型
        'measurement_id', // 中间表关联当前Measurement模型的外键
        'id', // 目标MeasurementField表的主键
        'id', // 当前Measurement模型的主键
        'measurement_field_id' // 中间表关联目标MeasurementField表的外键
    );
}

2. MeasurementData 模型

public function measurement() {
    return $this->belongsTo(Measurement::class, 'measurement_id'); 
}

// 正确关联对应的字段配置
public function measurement_field() {
    return $this->belongsTo(MeasurementField::class, 'measurement_field_id');
}

3. MeasurementField 模型

// 一个字段配置对应多条测量数据
public function measurement_datas() {
    return $this->hasMany(MeasurementData::class, 'measurement_field_id'); 
}

4. 控制器方法

根据你的业务需求二选一即可：

public function index()
{
    // 方案1：只需要返回测量项关联的所有字段配置，直接用hasManyThrough关联
    return JsonResource::collection(Measurement::with(['clients', 'measurement_fields'])->get());

    // 方案2：需要同时返回测量数据值和对应的字段配置，用嵌套关联
    // return JsonResource::collection(Measurement::with(['clients', 'measurement_datas.measurement_field'])->get());
}

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