Laravel Blade模板中如何正确获取外键关联的关联表数据

核心错误点 #

• 视图调用的关联属性名与模型定义的方法名不匹配
• 自定义外键未显式指定，导致关联查询返回null
• 未对空关联做容错处理
• 存在N+1查询性能隐患

具体修复步骤 #

1. 修正Product模型的关联定义 #

显式指定关联外键，匹配你实际表结构的products_id字段：

// app/Product.php
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Product extends Model
{
    public function sector()
    {
        // 参数说明：关联模型、关联表的外键、本模型的主键
        return $this->hasOne('App\Sector', 'products_id', 'id');
    }

    public function sale()
    {
        return $this->hasOne('App\Sale');
    }
}

2. 修正Sector模型的双向关联定义 #

同步指定belongsTo的外键参数，保证双向关联都能正常匹配：

// app/Sector.php
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Sector extends Model
{
    protected $primaryKey = 'products_id';
    // 如果Sector表不需要自动维护时间戳，可添加 protected $timestamps = false;

    public function product()
    {
        // 参数说明：关联模型、本表的外键、关联表的主键
        return $this->belongsTo('App\Product', 'products_id', 'id');
    }
}

3. 控制器预加载关联 #

用with预加载关联数据，避免遍历商品时每一条都单独查询关联表的N+1性能问题：

// app/Http/Controllers/ProductController.php index方法
public function index()
{
    $products = Product::with('sector')->get();
    return view('worker.index', compact('products'));
}

4. 视图正确取值 #

关联属性名和模型方法名保持一致（为单数sector），加null安全操作符避免关联不存在时报错：

@foreach ($products as $product)
    <div class="card" style="width: 18rem;">
        <div class="card-body">
            <h5 class="card-title">{{ $product->name }}</h5>
            <p class="card-text">{{ $product->codice_prodotto }}</p>
            {{-- 取值方式：?-> 会在sector为null时直接返回空，不会触发非对象报错 --}}
            <p>关联Sector标识：{{ $product->sector?->products_id }}</p>
        </div>
    </div>
@endforeach

原报错原因说明 #

• 你之前视图里写的$product->sectors（复数）和模型中定义的sector()（单数）方法名不匹配，Eloquent无法定位到对应关联，直接返回null。
• 你自定义Sector表的外键为products_id，但Eloquent默认会匹配product_id字段，未命中对应字段导致关联查询返回null，进而触发“尝试获取非对象属性”的报错。

注意：如果实际业务中一个Product对应多个Sector，需要把Product模型中的关联改为hasMany，视图中遍历关联取值即可。

内容的提问来源于stack exchange，提问作者Danilo Patanè