Laravel本地Scope触发BadMethodCallException，无法调用自定义查询作用域

嘿，我之前也碰到过这个棘手的问题，咱们一起来捋捋怎么解决它：

1. 检查模型文件命名规范 #

Laravel严格遵循PSR-4自动加载规则，你的模型文件必须命名为Task.php（首字母大写，和类名完全一致），并且放在app/目录下。如果文件名是小写的task.php或者拼写错误，自动加载机制会找不到你自定义的模型类，导致调用的是默认的查询构建器而非你的Task模型，自然就找不到completed方法了。

2. 清除Laravel缓存 #

有时候Laravel会缓存类的加载信息，尤其是开启了OPcache或者执行过php artisan optimize命令的情况下。执行以下命令彻底清除各类缓存：

php artisan clear-compiled
php artisan cache:clear
php artisan config:clear
php artisan route:clear

如果你的服务器开启了OPcache，可能还需要重启PHP服务或者手动刷新OPcache缓存。

3. 确认作用域方法的定义正确性 #

虽然你的代码看起来没问题，但再仔细核对一下细节：

• 方法必须是public访问权限
• 方法名必须以scope开头，后面跟着驼峰式命名（比如scopeCompleted）
• 第一个参数必须是$query（Illuminate\Database\Eloquent\Builder实例）
  这一步主要是排除拼写错误，比如把scope写成scrope这类低级失误。

4. 重新加载开发环境 #

有时候在本地开发时，IDE的自动加载或者开发服务器的缓存没有及时更新，你可以尝试：

• 重启本地开发服务器（比如php artisan serve、Valet或者Homestead）
• 在IDE中重新索引项目文件

测试验证 #

完成以上步骤后，再运行你的查询代码试试：

$completedTasks = App\Task::completed()->get();
dd($completedTasks);

这下应该就能正常获取到已完成的任务数据了。

内容的提问来源于stack exchange，提问作者sava milin