使用Maatwebsite Excel分块导入大文件时遇filter()方法未定义错误求助

你遇到这个错误是因为Laravel Excel（Maatwebsite Excel）的版本不匹配：你参考的是旧版本（2.x系列）的文档写法，但实际安装的是3.x及以上的新版本。新版本已经完全重构了API，移除了filter()、load()这些旧方法，所以会报“方法未定义”的错误。

根据你使用的版本，分两种情况处理：

情况1：使用3.x及以上版本（推荐） #

新版本采用面向类的导入方式，需要创建一个导入类来实现分块读取：

1. 创建导入类（比如app/Imports/YourDataImport.php）：

namespace App\Imports;

use Maatwebsite\Excel\Concerns\ToModel;
use Maatwebsite\Excel\Concerns\WithChunkReading;

class YourDataImport implements ToModel, WithChunkReading
{
    // 处理每一行数据
    public function model(array $row)
    {
        // 这里写你原来在foreach里的逻辑，比如存入数据库
        // 示例：创建模型
        // return new YourModel([
        //     'field1' => $row[0],
        //     'field2' => $row[1],
        // ]);
    }

    // 设置分块大小，对应你原来的250
    public function chunkSize(): int
    {
        return 250;
    }
}

2. 在控制器/命令中调用导入：

use App\Imports\YourDataImport;
use Maatwebsite\Excel\Facades\Excel;

Excel::import(new YourDataImport, 'file.csv');

情况2：降级到2.x版本（不推荐，仅适配旧代码） #

如果想继续用旧写法，需要把包降级到2.1版本：

1. 修改composer.json中的版本约束：

"maatwebsite/excel": "^2.1"

2. 执行更新命令：

composer update maatwebsite/excel

3. 之后你的原有代码就能正常运行了，但注意2.x版本不再维护，存在安全风险。

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