Laravel中Maatwebsite/Laravel-Excel如何跳过文件上传实现导入

核心逻辑说明 #

之前基于表单上传的导入逻辑，传入Excel::import的是上传组件返回的UploadedFile实例；Maatwebsite/Laravel-Excel 3.1+ 版本本身就支持直接传入本地文件的绝对路径，不需要依赖上传环节的文件实例，只需要解决路径解析错误的问题即可。

修正步骤 #

• 替换裸写的相对路径，改用Laravel内置的路径辅助函数生成绝对路径，避免因为进程工作目录不同导致文件查找失败：
  • 如果文件存放在项目根目录下的storage/excel文件夹中，使用storage_path('excel/file.xlsx')生成绝对路径
  • 如果文件存放在默认文件磁盘（通常是storage/app目录）对应的excel文件夹下，使用Storage::path('excel/file.xlsx')生成绝对路径，这种方式和Laravel的文件系统配置完全匹配，兼容性最好
  • 不要直接写"storage/excel/file.xlsx"这类相对路径，不管是文件存在性检查还是组件读取，都可能出现路径解析错误
• 保持Excel::import的调用逻辑不变，直接把生成的绝对路径传入即可，不需要额外做文件类型转换

修正后的完整控制器代码 #

// 顶部先引入需要的门面
use Maatwebsite\Excel\Facades\Excel;
use Illuminate\Support\Facades\Storage;

public function import()
{
    // 用文件系统门面生成对应磁盘的文件绝对路径，适配配置最稳妥
    $absoluteFilePath = Storage::path('excel/file.xlsx');

    // 也可以根据文件实际存放位置替换为storage_path写法
    // $absoluteFilePath = storage_path('excel/file.xlsx');

    if (!file_exists($absoluteFilePath)) {
        return back()->withErrors('指定路径下未找到Excel文件，请检查存放位置');
    }

    // 直接传入本地文件绝对路径完成导入
    Excel::import(new ProductsSerialsImport, $absoluteFilePath);

    return redirect()->back()->with('success', '文件已完成导入更新!');
}

路由说明 #

原有的POST路由配置不需要修改，直接触发即可正常执行导入逻辑：

Route::post('products_serials/import', 'ProductsSerialsController@import')->name('products_serials.import');

注意：如果不需要校验表单请求，也可以根据使用场景把路由方法从POST改成GET，降低触发门槛。

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