Laravel 10任务中调用FastExcel::import()提示方法未定义（方法存在）

核心报错原因 #

报错Call to undefined method Rap2hpoutre\FastExcel\Facades\FastExcel::import()的本质是任务代码中实际调用的是FastExcel的Facade类，而非提供import方法的原生类。以下是具体诱因和解决办法：

1. 队列Worker未加载最新代码 #

队列Worker启动后会常驻内存，修改任务类代码后，Worker不会自动刷新代码缓存。如果旧版本任务代码中误用了FastExcel Facade（而非实例化原生类），就会触发这个错误。

解决办法：
执行命令重启队列Worker，强制加载最新代码：

php artisan queue:restart

2. 类导入别名冲突 #

Laravel的config/app.php中若配置了FastExcel的别名：

'aliases' => [
    // ...
    'FastExcel' => Rap2hpoutre\FastExcel\Facades\FastExcel::class,
],

此时任务类中的use Rap2hpoutre\FastExcel\FastExcel;会被别名覆盖，实际实例化的是Facade类（该类没有import方法）。

解决办法：
使用完全限定类名实例化原生FastExcel类，绕过别名冲突：

$contacts = (new \Rap2hpoutre\FastExcel\FastExcel)->import($this->path, function ($row) {
    // 你的导入逻辑
});

额外隐藏问题 #

你的任务类中使用auth()->user()->id会导致报错，因为队列任务运行在无HTTP请求的上下文环境中，auth()->user()会返回null。

修复方法：
直接使用构造函数中传入的$ownerId：

$contact->owner_id = $this->ownerId;

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