Laravel使用Eloquent关联查询报Property [countries]不存在错误如何解决

问题根因 #

1. 第一次报错的原因：Subcontinent::orderBy('id', 'DESC')->get() 返回的是次大陆模型的集合，不是单个模型实例，关联属性countries是单个次大陆模型才有的属性，不能直接在集合上调用。
2. 单条查询返回null的原因：模型关联的外键配置和表结构不匹配：
   • 你的divisions表用来关联次大陆的外键是subcontinent_id，不是country_name
   • 你在hasMany和belongsTo里错误填写country_name作为关联键，导致关联查询匹配不到数据。

第一步：修正模型关联代码 #

修正Subcontinent模型 #

class Subcontinent extends Model
{
    protected $guarded = [];

    public function countries()
    {
        // hasMany参数：1.关联模型类 2.子表(divisions)的外键字段 3.父表主键(默认id可省略)
        return $this->hasMany(Division::class, 'subcontinent_id', 'id');
    }
}

修正Division模型 #

class Division extends Model
{
   protected $table = 'divisions';
   protected $fillable = [
       'country_name', 'subcontinent_id'
   ];

   public function subcontinent()
   {
       // belongsTo参数：1.关联模型类 2.当前表(divisions)的外键字段 3.父表主键(默认id可省略)
       return $this->belongsTo(Subcontinent::class, 'subcontinent_id', 'id');
   }
}

第二步：正确查询关联数据 #

场景1：查询所有次大陆及对应国家（适合前端一次性加载做无请求联动） #

使用with预加载关联，避免N+1查询问题：

$subcontinents = Subcontinent::with('countries')->orderBy('id', 'DESC')->get();

取值示例：

foreach($subcontinents as $subcontinent) {
    // 拿到当前次大陆对应的所有国家
    $countries = $subcontinent->countries;
}

场景2：查询单个次大陆及对应国家（适合前端选了次大陆后异步请求拿对应国家） #

// 1为次大陆的id，按实际传入参数替换
$subcontinent = Subcontinent::with('countries')->find(1);
// 直接获取对应国家
$countries = $subcontinent->countries;

二级联动实现参考 #

• 前后端分离场景：页面初始化请求所有次大陆列表渲染一级下拉，用户选中次大陆后，携带次大陆id请求接口查询对应国家列表渲染二级下拉即可。
• 服务端渲染场景：把预加载了国家的次大陆集合传到前端，转成JSON存在本地变量，用户选择次大陆时直接从本地变量筛选对应国家渲染，无需发请求。

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