Laravel Excel导入报错：Cannot access offset of type string on string

问题背景 #

使用Laravel Excel开发数据导入功能时，触发错误：Cannot access offset of type string on string

Excel数据示例 #

url                    content_placement_price    article_price long_article
https://web.whatsapp.com/    12                      33          66

dd($rows)输出结果 #

array:4 [ // app\Imports\DataImport.php:16
  0 => "url"
  1 => "content_placement_price"
  2 => "article_price"
  3 => null
]

报错相关代码 #

控制器代码 #

public function AddWebsiteListByPublisher(){
    Excel::import(new DataImport(), $this->file);
}

DataImport类代码 #

class DataImport implements ToModel
{
public function model(array $rows)
{
    try {
           
        foreach ($rows as $row) {
            
                WlProducts::create([
                    'url' => $row['url'],
                    'content_placement_price' => $row['content_placement_price'],
                    'mini_post_price' => $row['mini_post_price'],
                    'article_price' => $row['article_price'],
                    'long_article' => $row['long_article'],
                ]);
        }

        DB::commit();
    } catch (\Exception $e) {
        DB::rollBack();
        // Handle the exception (log, return an error response, etc.)
    }
}
}

错误原因分析 #

1. ToModel接口逻辑误解：model方法是Laravel Excel处理单一行数据的回调，每次调用传入的$rows就是一行的索引数组，而非所有行的集合。你在方法内循环$rows，会遍历数组中的每个字符串元素（比如"url"），此时$row是字符串，尝试访问$row['url']必然触发"字符串上无法访问偏移量"的错误。
2. 未启用表头关联：默认情况下，Laravel Excel返回索引数组（键为0、1、2...），直接用表头字符串作为键访问本身就会报错。

修复方案 #

步骤1：实现WithHeadingRow接口 #

启用表头识别，让Laravel Excel将行数据转换为关联数组（键为表头字段名）。

步骤2：修正model方法逻辑 #

去掉多余的循环，直接处理当前行数据，同时处理可能缺失的字段。

修改后的DataImport代码 #

use Maatwebsite\Excel\Concerns\WithHeadingRow;

class DataImport implements ToModel, WithHeadingRow
{
    public function model(array $row)
    {
        DB::beginTransaction();
        try {
            WlProducts::create([
                'url' => $row['url'] ?? null,
                'content_placement_price' => $row['content_placement_price'] ?? null,
                'mini_post_price' => $row['mini_post_price'] ?? null, // Excel中无此字段，需设默认值或检查Excel结构
                'article_price' => $row['article_price'] ?? null,
                'long_article' => $row['long_article'] ?? null,
            ]);
            
            DB::commit();
        } catch (\Exception $e) {
            DB::rollBack();
            // 可选：记录错误日志
            // \Illuminate\Support\Facades\Log::error('数据导入失败: ' . $e->getMessage());
        }
    }
}

额外注意事项 #

• 检查Excel表头与代码中使用的键是否完全一致（注意空格、大小写，Laravel Excel默认会将表头转为小写并替换空格为下划线，比如content_placement_price对应Excel中的content placement price）。
• 若需要批量插入提升性能，可改用ToCollection接口，一次性处理所有行数据再批量插入。

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