Laravel关联报错：Attempt to read property 'name' on null 求助

以下是几个核心排查点，按优先级排序：

1. 关联关系与表结构完全不匹配 #

你给Listing和Location定义的是一对多关联（Listing属于一个Location，一个Location有多个Listing），但却创建了多对多关联才需要的中间表listing_location，这是核心矛盾：

• 如果业务确实是一对多：
  • 删掉listing_location中间表，给listings表添加location_id外键字段：

    // 修改listings表的迁移文件
    public function up(): void
    {
        Schema::table('listings', function (Blueprint $table) {
            $table->unsignedBigInteger('location_id')->nullable();
            $table->foreign('location_id')->references('id')->on('locations');
        });
    }
    

• 如果实际业务是多对多（一个Listing对应多个Location，反之亦然）：
  • 把模型里的关联改成belongsToMany：

    // Listing模型
    public function locations(): BelongsToMany
    {
        return $this->belongsToMany(Location::class);
    }
    
    // Location模型
    public function listings(): BelongsToMany
    {
        return $this->belongsToMany(Listing::class);
    }
    

  • 同时Blade视图要遍历多对多关联，不能直接取$listing->location：

    @foreach ($featured_listings as $listing)
        @foreach($listing->locations as $location)
            {{ $location->name }}
        @endforeach
    @endforeach
    

2. Location模型主键设置与关联/迁移冲突 #

你给Location模型设置了protected $primaryKey = 'slug';，但迁移和关联方法都在使用默认的id主键：

• 如果确实要以slug作为Location的主键：
  • 修改locations表迁移，把slug设为主键（注意类型要匹配，用字符串）：

    Schema::create('locations', function (Blueprint $table) {
        $table->string('slug')->primary();
        // 其他字段（如name）...
    });
    

  • 修正关联方法，指定外键和关联的主键：

    // Listing模型的关联
    public function location(): BelongsTo
    {
        return $this->belongsTo(Location::class, 'location_id', 'slug');
    }
    
    // Location模型的关联
    public function listings(): HasMany
    {
        return $this->hasMany(Listing::class, 'location_id', 'slug');
    }
    

  • 如果是多对多关联，还要修改中间表的location_id字段类型为字符串：

    $table->string('location_id');
    $table->foreign('location_id')->references('slug')->on('locations');
    

3. 数据层面的关联字段为空 #

检查listings表中featured=1的记录，是否存在location_id为null的情况——这类记录的$listing->location会返回null，直接访问name就会报错。

• 临时解决可以在Blade里做判空处理：

  @foreach ($featured_listings as $listing)
      {{ $listing->location?->name ?? '无位置信息' }}
  @endforeach
  

• 长期解决要补全数据，或者给location_id添加非空约束（如果业务要求每个Listing必须有Location）。

4. 预加载关联优化（潜在风险） #

虽然不是直接导致报错的原因，但控制器中没有预加载关联，会导致循环时触发N+1查询，建议优化：

public function show(): View
{
    return view('pocetna', [
        'featured_listings' => Listing::with('location')->where('featured', 1)->get()
    ]);
}

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