Laravel Excel使用WithHeadingRow时提示找不到header索引的解决办法

根因分析 #

Laravel Excel 的 Excel 行计数规则为从 1 开始，而非数组默认的 0 索引。你配置 headingRow() 返回 0，实际指向了不存在的行，系统不会将你 Excel 第一行的 productId、productName 识别为表头，只会当做普通数据行处理，此时 $row 为数字索引 0、1，自然不存在 product_id 这个字符串索引。

修复方案 #

1. 调整表头行号配置，将 headingRow() 返回值改为 1，指定 Excel 第一行为表头：

public function headingRow(): int
{
    return 1;
}

Laravel Excel 默认会将驼峰格式的表头自动转换为蛇形小写，productId 会自动转为 product_id，productName 会转为 product_name，和你代码里的索引写法完全匹配，无需额外修改其他逻辑。
2. 可选调试步骤
如果调整后仍然报错，可以临时打印 $row 确认表头转换后的键名，避免表头存在空格、特殊字符导致转换结果不符合预期：

public function model(array $row): ?RandomRotationProduct
{
    // 调试完成后删除即可
    dd($row);
    return new RandomRotationProduct([
        'product_id' => $row['product_id'],
        'product_name' => $row['product_name']
    ]);
}

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