Laravel 中自定义模型作用域时，若方法名与 Eloquent 内置查询方法（如 `latest`、`oldest`、`with` 等）重名，将导致作用域被忽略——实际调用的是框架原生方法，而非你的逻辑。
在 Laravel 中，模型的局部作用域（Local Scopes） 是以 scope 开头、首字母大写的公共方法（例如 scopeLatest），它允许你链式调用并复用查询逻辑。但关键前提是：该方法名不能与 Eloquent Builder 已存在的公开方法冲突。
你遇到的问题根源正在于此：
// ❌ 错误：scopeLatest 与 Eloquent 的内置 latest() 方法冲突
public function scopeLatest(Builder $query, int $limit)
{
return $query->select(['id', 'title', ...])
->whereIn('status', ['Dostepne', 'Zarezerwowane'])
->orderBy('id', 'desc')
->limit($limit);
}当你调用 Test::latest(3)->get() 时，PHP 并未触发作用域机制，而是直接调用了 Illuminate\Database\Eloquent\Builder::latest()（该方法默认按 created_at DESC 排序，且不接受参数）。由于你的 scopeLatest 方法未被调用，后续 ->get() 返回的是全表数据（或空结果，取决于是否触发了其他隐式条件）——这正是你观察到“作用域无效”的原因。
✅ 正确做法：为作用域选择唯一、非保留的名称，例如 scopeLatestAvailable、scopeTopActive 或 scopeRecentListings：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
// ✅ 正确：使用无冲突的作用域名
public function scopeLatestAvailable($query, int $limit = 3)
{
return $query
->select(['id', 'title', 'main_photo', 'area', 'price', 'city', 'short_desc'])
->whereIn('status', ['Dostepne', 'Zarezerwowane'])
->orderBy('id', 'desc')
->limit($limit);
}控制器中调用方式同步更新：
// ✅ 正确调用自定义作用域 $flats = Test::latestAvailable(3)->get();
? 补充说明：
- Laravel 通过 __call() 魔术方法拦截对不存在/不可访问方法的调用，并尝试匹配 scopeXxx 格式的方法。一旦方法名已在 Builder 中存在（如 latest, where, with, first, count 等），则直接执行原生逻辑，跳过作用域查找。
- 建议查阅 Eloquent Builder 官方文档 或使用 IDE 的代码跳转功能，确认目标方法名是否已被占用。
- 若需覆盖内置行为（极少数场景），应显式使用 newQuery() + 自定义构建器，而非依赖作用域。
? 最佳实践总结：
- 作用域命名推荐采用语义化前缀（如 available, active, published）+ 动词结构；
- 避免使用 Laravel 查询构造器中任意公开方法名（包括带参数和不带参数的版本）；
- 开发时可通过 dd(Test::getQuery()->toString()) 或数据库日志验证最终 SQL 是否符合预期。
这样，你的作用域就能真正生效，精准返回符合条件的最新三条记录。
