使用Laravel Excel导出文件导致服务器崩溃问题求助

尝试使用Laravel Excel库导出Excel或CSV文件，执行Excel::store或Excel::download操作时都会导致服务器崩溃。已启用gd扩展，同一PHP服务器上的其他项目可正常生成并下载Excel文件。

接口调用表现：Postman请求导出接口后长时间无响应，最终服务器崩溃。

控制器代码如下：

public function exportPurchases(Request $request)
{
    $query = QueryBuilder::for(Purchase::class)
        ->with(['customer', 'productCategory'])
        ->allowedFilters(
            [
                AllowedFilter::partial('product_no')->ignore(['']),
                AllowedFilter::partial('model_no')->ignore(['']),
                AllowedFilter::partial('serial_no')->ignore(['']),
                AllowedFilter::partial('productCategory.name')->ignore(['']),
                AllowedFilter::scope('date_of_purchase_lte')->ignore(['']),
                AllowedFilter::scope('date_of_purchase_gte')->ignore(['']),
                AllowedFilter::partial('customer.first_name')->ignore(['']),
                AllowedFilter::partial('customer.surname')->ignore(['']),
                AllowedFilter::partial('customer.mobile')->ignore(['']),
                AllowedFilter::partial('customer.email')->ignore(['']),
                AllowedFilter::partial('customer.town')->ignore(['']),
                AllowedFilter::partial('customer.region')->ignore(['']),
                AllowedFilter::partial('dealer.name')->ignore(['']),
            ]);
    Excel::store(new PurchaseExport($query), 'purchases.csv', 'public');
    return [];
}

• 检查数据量与分批导出
  先执行$query->count()查看返回记录数，若数据量过大（比如超过1万条），一次性加载会耗尽内存。需在PurchaseExport类中实现分批处理：

  class PurchaseExport implements FromQuery, WithChunkReading
  {
      protected $query;
  
      public function __construct($query)
      {
          $this->query = $query;
      }
  
      public function query()
      {
          return $this->query;
      }
  
      public function chunkSize(): int
      {
          return 1000; // 按1000条分批处理
      }
  }
  

• 查看服务器错误日志
  查看PHP错误日志（通常在/var/log/php/或项目storage/logs目录），定位崩溃时的具体错误，比如内存溢出、超时、关联模型加载异常等。

• 验证PurchaseExport类实现
  检查map方法是否存在复杂逻辑或循环引用，比如嵌套关联模型处理不当导致内存泄漏：

  public function map($purchase): array
  {
      return [
          $purchase->product_no,
          $purchase->customer->first_name . ' ' . $purchase->customer->surname,
          // 其他字段需确保无深层嵌套或冗余数据
      ];
  }
  

• 临时调整PHP内存限制
  在控制器开头增加内存限制，测试是否因内存不足导致崩溃：

  ini_set('memory_limit', '256M');
  

• 极简场景测试
  注释掉查询的关联和筛选条件，只导出少量固定数据：

  $query = Purchase::take(10); // 仅取10条数据
  Excel::store(new PurchaseExport($query), 'test.csv', 'public');
  

  若能正常导出，再逐步恢复筛选和关联条件，定位问题环节。

• 检查版本兼容性
  确认当前Laravel版本与Laravel Excel版本匹配，比如Laravel 10需搭配Laravel Excel 3.1及以上版本，版本不兼容可能引发未知错误。

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