Drupal 8自定义模块开发问题：Excel导入配送卡号失效求助

一、卡号无法读取的排查与解决 #

• 确认Excel文件格式：优先使用.xlsx格式，避免老旧的.xls格式导致读取库兼容性问题。
• 修正单元格格式：将卡号列设置为文本格式，防止长卡号被自动转为科学计数法或丢失末尾有效数字。操作方法：选中卡号列 → 右键「设置单元格格式」→ 选择「文本」→ 重新保存文件。
• 排查读取代码逻辑：
  • 确保PhpSpreadsheet库初始化正确：

    $reader = \PhpOffice\PhpSpreadsheet\IOFactory::createReader('Xlsx');
    $spreadsheet = $reader->load($file_path);
    $worksheet = $spreadsheet->getActiveSheet();
    

  • 验证列索引匹配：确认代码中读取的列与Excel中卡号所在列一致（PhpSpreadsheet列索引从1开始，比如B列对应索引2），示例：

    $card_number = $worksheet->getCellByColumnAndRow(2, $current_row)->getValue();
    

  • 处理值格式化：若单元格为数字格式，改用getFormattedValue()获取原始显示值，避免自动转换：

    $card_number = $worksheet->getCellByColumnAndRow(2, $current_row)->getFormattedValue();
    

二、导入后卡片数量未增加的排查与解决 #

• 检查实体保存逻辑：
  • 确认自定义卡片实体创建与保存代码正确，示例：

    $card = \Drupal\your_module\Entity\Card::create([
      'card_number' => $card_number,
      'card_type' => $selected_card_type_id, // 确保传入的是类型ID而非名称
      'status' => 1, // 若需直接生效，设置状态为启用
    ]);
    $card->save();
    

  • 验证字段合规性：保存前添加验证逻辑，排查字段错误：

    $violations = $card->validate();
    if ($violations->count() > 0) {
      foreach ($violations as $violation) {
        \Drupal::logger('your_module')->error('卡片验证失败：@message', ['@message' => $violation->getMessage()]);
      }
      continue;
    }
    

• 排查事务与错误捕获：
  • 导入过程开启事务，防止中途出错导致数据回滚：

    $transaction = \Drupal::database()->startTransaction();
    try {
      // 循环读取Excel行并保存卡片逻辑
      $transaction->commit();
    } catch (\Exception $e) {
      $transaction->rollBack();
      \Drupal::logger('your_module')->error('导入失败：@message', ['@message' => $e->getMessage()]);
    }
    

  • 查看Drupal系统日志（/admin/reports/dblog），搜索模块相关错误，比如权限不足、字段缺失、类型ID不匹配等问题。
• 验证数量统计逻辑：若网店卡片数量基于视图展示，检查视图筛选条件是否包含新导入卡片的状态（比如是否需要审核通过才统计），或确认统计逻辑是否正确关联了新创建的卡片实体。

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