使用Laravel Excel导入多工作表无法获取格式化单元格值求助

• 确认版本是否包含修复
  检查composer.json中maatwebsite/excel的版本，该bug修复对应3.1.28及以上版本。如果版本过低，执行composer update maatwebsite/excel更新到最新稳定版，之后清理缓存：

  php artisan cache:clear
  php artisan config:clear
  

• 检查WithFormatData的正确使用
  确保导入类同时实现ToCollection和WithFormatData，并引入Importable trait，且没有用其他逻辑覆盖格式处理。示例代码：

  use Maatwebsite\Excel\Concerns\WithFormatData;
  use Maatwebsite\Excel\Concerns\ToCollection;
  use Maatwebsite\Excel\Concerns\Importable;
  use Illuminate\Support\Collection;
  
  class SheetImport implements ToCollection, WithFormatData
  {
      use Importable;
  
      public function collection(Collection $rows)
      {
          foreach ($rows as $row) {
              // 直接获取格式化后的电话号码
              $formattedPhone = $row[0];
          }
      }
  }
  

  注意：如果同时使用WithCustomValueBinder，会干扰WithFormatData的效果，需暂时禁用自定义绑定器测试。

• 验证Excel单元格的实际存储值
  有些Excel的电话号码格式只是显示层，单元格实际存储的是纯数字（比如显示+11234567890，但底层是11234567890）。这种情况下WithFormatData无法获取显示值，需要手动拼接前缀：

  $formattedPhone = '+1' . $row[0];
  

  可以用Excel的FORMULATEXT函数查看单元格实际内容，确认存储类型。

• 直接调用PhpSpreadsheet原生方法读取格式化值
  绕过集合，通过WithEvents监听AfterSheet事件，直接读取单元格的格式化显示值：

  use Maatwebsite\Excel\Concerns\WithEvents;
  use Maatwebsite\Excel\Events\AfterSheet;
  
  class SheetImport implements ToCollection, WithFormatData, WithEvents
  {
      use Importable;
  
      public function registerEvents(): array
      {
          return [
              AfterSheet::class => function(AfterSheet $event) {
                  $sheet = $event->sheet->getDelegate();
                  $maxRow = $sheet->getHighestRow();
                  // 从第二行开始（假设第一行是表头）
                  for ($row = 2; $row <= $maxRow; $row++) {
                      $formattedPhone = $sheet->getCell('A' . $row)->getFormattedValue();
                      // 处理格式化后的号码
                  }
              },
          ];
      }
  
      public function collection(Collection $rows)
      {
          // 保持原有逻辑或留空
      }
  }
  

• 多工作表的特殊处理
  如果是多工作表导入，确保每个子工作表的导入类都实现了WithFormatData。示例：

  use Maatwebsite\Excel\Concerns\WithMultipleSheets;
  
  class MultiSheetImport implements WithMultipleSheets
  {
      public function sheets(): array
      {
          return [
              new SheetImport(), // 每个子导入类都要实现WithFormatData
              new UserSheetImport(),
          ];
      }
  }
  

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