Laravel 10中Maatwebsite Excel在cPanel无报错终止问题求助

以下是针对你遇到的问题（本地/VMware Ubuntu正常，cPanel执行CountryXlsxSeeder时卡在Excel::import步骤无错误）的具体排查和解决方向：

1. 检查PHP必需扩展是否齐全 #

phpoffice/phpspreadsheet（Laravel Excel依赖）需要以下PHP扩展支持，cPanel环境可能未默认开启：

• ext-zip（读取压缩格式的xlsx文件必需）
• ext-xml
• ext-gd
• ext-mbstring

排查方法：执行命令查看已安装扩展

ea-php82 -m

对比本地环境的扩展列表，如果缺少上述扩展，在cPanel的「PHP选择器」中找到对应扩展并启用。

2. 验证文件与临时目录权限 #

• 虽然is_file判断文件存在，但读取xlsx文件时可能需要额外权限，可执行命令确认文件权限：

ls -l database/sheets/ImportSheets/countries.xlsx

确保文件权限为644左右，且所属用户与cPanel网站运行用户一致。

• Laravel Excel会使用系统临时目录处理文件，cPanel下临时目录权限可能受限。可手动指定临时目录：
  在config/excel.php中添加或修改：

  'temporary_path' => storage_path('framework/excel-temp'),
  

  然后创建该目录并设置权限：

  mkdir -p storage/framework/excel-temp
  chmod -R 755 storage/framework/excel-temp
  

3. 调高PHP内存限制 #

读取xlsx文件（尤其是大文件）可能超出cPanel默认的PHP内存限制，导致进程静默终止。

• 临时调高内存执行命令：

ea-php82 -d memory_limit=256M artisan db:seed --class=CountryXlsxSeeder

• 永久修改：在cPanel的「PHP设置」中调整memory_limit参数至256M或更高。

4. 简化Import类的接口实现 #

你的CountryImport同时实现了WithMultipleSheets、ToModel、WithHeadingRow接口，可能在cPanel环境的PHP版本下存在逻辑冲突：
如果你的xlsx文件只有一个名为countries的工作表，完全不需要WithMultipleSheets接口。修改CountryImport代码：

<?php

namespace Database\Sheets\ImportClasses;

use App\Models\MasterData\Country;
use Maatwebsite\Excel\Concerns\ToModel;
use Maatwebsite\Excel\Concerns\WithStartRow;
use Maatwebsite\Excel\Concerns\WithHeadingRow;

class CountryImport implements ToModel, WithStartRow, WithHeadingRow
{
    public function model(array $row)
    {
        return new Country([
            'code'         => $row['code'],
            'name'         => $row['name'],
            'native_name'  => $row['native_name'],
            'iso_code_3'   => $row['iso_code_3'],
        ]);
    }

    public function startRow(): int
    {
        return 2;
    }
}

去掉WithMultipleSheets接口和sheets()方法后重新测试。

5. 查看错误日志定位问题 #

cPanel环境下，命令行未输出错误不代表没有错误，可查看以下日志：

• Laravel日志：storage/logs/laravel.log，搜索CountryImport或Excel相关关键词。
• PHP错误日志：在cPanel的「错误日志」功能中查看，或找到服务器上的PHP错误日志路径（通常为/home/[你的用户名]/logs/php_error.log）。

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