如何在 Laravel 中通过嵌套关联关系进行 orderBy 排序

laravel 的 `orderby()` 无法直接对 `with()` 预加载的深层关联字段（如 `file.property.full_address`）排序，必须通过 `join()` 显式关联表并引用实际数据库列才能实现。

在 Laravel 中，orderBy('file.property.full_address') 这类写法会报错 Unknown column 'file.property.full_address'，根本原因在于：orderBy() 只作用于主查询表（此处为 finance_invoices）的字段，或已通过 JOIN 引入的表字段；而 with() 是独立的预加载查询，其关联表不会出现在主 SQL 的 FROM/JOIN 子句中，因此无法被 ORDER BY 引用。

✅ 正确做法是使用 join() 显式连接关联表链，并在 orderBy() 中使用带表别名的字段名。假设你的模型关系如下：

Finance_Invoices → file()（一对一，关联 finance_files 表）
Finance_File → property()（一对一，关联 properties 表）
Property → landlord()（一对多/一对一，关联 landlords 表）

则可改写为：

$invoices = \App\Finance_Invoices::query()
    ->select('finance_invoices.*') // 显式指定主表字段，避免 SELECT *
    ->join('finance_files', 'finance_invoices.file_id', '=', 'finance_files.id')
    ->join('properties', 'finance_files.property_id', '=', 'properties.id')
    ->join('landlords', 'properties.landlord_id', '=', 'landlords.id')
    ->where('finance_invoices.period', '02')
    ->where('finance_invoices.year', '2025')
    ->where('finance_invoices.paid_to_landlord', 0)
    ->whereColumn('finance_invoices.total_paid', '>=', 'finance_invoices.amount')
    ->where('landlords.id', $id)
    ->orderBy('properties.full_address')
    ->get();

? 关键注意事项：

使用 join() 后，若需保留 Eloquent 模型实例（如触发访问器、属性转换），建议配合 ->with('file.property.landlord') 预加载（但排序逻辑仍由 join 承担）；
若 file_id 或 property_id 允许为空（nullable），应改用 leftJoin() 并注意 WHERE 条件位置，避免意外过滤掉空关联记录；
字段名务必加上表前缀（如 'properties.full_address'），防止歧义或冲突；
如需分页，join 查询默认支持 ->paginate()，但要注意 distinct 或 group by 场景下可能需手动处理重复数据。

? 总结：Laravel 不支持对 with() 关联路径做 orderBy，这是底层 SQL 限制，而非框架缺陷。始终记住——排序依赖 JOIN，预加载仅用于数据补充。 正确组合 join() + with()，即可兼顾性能与功能。