Laravel预加载属性无法在where查询中访问的问题

你遇到的错误核心在于：with('stage', 'project')是Eloquent的预加载机制，它的作用是查询主表（lands）完成后，再批量拉取关联的stage和project表数据，并不会把这两个关联表加入到主查询的FROM/JOIN子句中。因此当你直接在where条件里使用stage.name时，SQL语句里找不到对应的stage表，就会抛出"missing FROM-clause entry"错误。

另外纠正一个细节：你示例中$availableLands = Land::with('stage', 'project');只是构建了查询实例，并未执行数据库查询，直接访问$availableLands->stage->name其实触发的是懒加载，而非预加载。正确的预加载查询应该是$availableLands = Land::with('stage', 'project')->first();或->get();之后再访问关联属性。

下面提供两种可行的解决方式，根据业务场景选择：

方式1：使用JOIN关联表 #

直接将stage和project表通过JOIN加入主查询，这样就能在WHERE条件中直接使用关联表的字段：

$search = $this->search;
$results = Land::leftJoin('stages', 'lands.stage_id', '=', 'stages.id')
    ->leftJoin('projects', 'lands.project_id', '=', 'projects.id')
    // 可选：指定查询字段，避免字段名冲突（比如stage和project都有name字段时）
    ->select('lands.*', 'stages.name as stage_name', 'projects.name as project_name')
    ->where(function($query) use ($search) {
        // 用闭包包裹OR条件，避免和后续其他WHERE条件逻辑冲突
        $query->where('stages.name', 'ilike', "%{$search}%")
            ->orWhere('projects.name', 'ilike', "%{$search}%")
            ->orWhere('lands.land_id', 'like', "%{$search}%");
    })
    ->paginate(15);

注意：请根据实际数据库表名调整stages、projects，以及关联字段stage_id、project_id（确保和Land模型中定义的关联外键一致）。

方式2：使用whereHas筛选关联模型 #

如果你想保留Eloquent的关联预加载逻辑，不想手动处理JOIN，可以使用whereHas方法，它会生成EXISTS子查询来筛选存在符合条件关联的Land记录：

$search = $this->search;
$results = Land::with('stage', 'project')
    ->where(function($query) use ($search) {
        $query->whereHas('stage', function($subQuery) use ($search) {
            $subQuery->where('name', 'ilike', "%{$search}%");
        })
        ->orWhereHas('project', function($subQuery) use ($search) {
            $subQuery->where('name', 'ilike', "%{$search}%");
        })
        ->orWhere('land_id', 'like', "%{$search}%");
    })
    ->paginate(15);

这种方式的优势是不需要关心关联表的JOIN条件，完全依赖你在Land模型中定义的关联关系，后续依然可以正常通过$land->stage->name访问预加载的关联数据。

• JOIN方案：一次查询获取所有数据，性能更优，适合需要对关联表字段进行排序、分组的场景；但需要手动处理表名和关联字段，代码相对繁琐。
• whereHas方案：代码更贴合Eloquent的关联设计，维护成本低；但会生成子查询，数据量较大时性能可能略低于JOIN。

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