Laravel Excel(Maatwebsite)验证：错误提示需显示Excel实际行号而非数组索引

要解决验证错误提示中行号显示为数组索引的问题，你可以通过逐行验证自定义消息或批量验证后修改错误信息两种方式，将提示中的行号替换为Excel实际行号，具体实现如下：

方式一：逐行验证并自定义消息 #

适合逐行处理数据的场景，直接在验证阶段指定包含实际行号的错误提示：

use Maatwebsite\Excel\Concerns\ToCollection;
use Maatwebsite\Excel\Concerns\WithHeadingRow; // 使用表头时需引入
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Validator;
use Maatwebsite\Excel\Validators\ValidationException;

class ProductsImport implements ToCollection, WithHeadingRow // 实现该接口表示Excel包含表头
{
    public function collection(Collection $rows)
    {
        // 设定数据起始行号：带表头时从第2行开始，无表头则设为1
        $startingRow = 2;

        foreach ($rows as $index => $row) {
            // 计算当前Excel实际行号
            $currentRow = $startingRow + $index;

            // 构建验证规则与自定义错误消息
            $validator = Validator::make(
                $row->toArray(),
                ['price' => 'required|numeric'],
                [
                    'price.numeric' => "Row No {$currentRow}.price must be a number.",
                    'price.required' => "Row No {$currentRow}.price is required."
                ]
            );

            // 验证失败时抛出异常，框架会返回自定义错误提示
            if ($validator->fails()) {
                throw new ValidationException($validator);
            }

            // 处理合法数据（例如写入数据库）
            // Product::create([
            //     'price' => $row['price'],
            //     // 其他字段逻辑
            // ]);
        }
    }
}

关键说明 #

• 起始行号$startingRow需根据Excel是否包含表头调整：带表头设为2，无表头设为1。
• 通过$startingRow + $index计算实际行号，$index是数组的0-based索引，对应Excel的连续行号。

方式二：批量验证后修改错误消息 #

如果需要一次性验证所有行数据，可以先完成批量验证，再遍历错误信息替换行号：

use Maatwebsite\Excel\Concerns\ToCollection;
use Maatwebsite\Excel\Concerns\WithHeadingRow;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Validator;
use Maatwebsite\Excel\Validators\ValidationException;

class ProductsImport implements ToCollection, WithHeadingRow
{
    public function collection(Collection $rows)
    {
        $startingRow = 2;
        $data = $rows->toArray();
        // 为每行设置相同的验证规则
        $rules = array_fill(0, count($data), ['price' => 'required|numeric']);

        $validator = Validator::make($data, $rules);

        if ($validator->fails()) {
            $customErrors = [];
            // 遍历错误信息，将数组索引替换为实际行号
            foreach ($validator->errors()->getMessages() as $index => $fieldErrors) {
                $currentRow = $startingRow + $index;
                foreach ($fieldErrors as $error) {
                    $customErrors[] = str_replace($index, "Row No {$currentRow}", $error);
                }
            }

            // 抛出包含自定义错误的异常
            throw new ValidationException(
                Validator::make([], []),
                collect($customErrors)
            );
        }

        // 批量处理合法数据
        // Product::insert($data);
    }
}

两种方式都能让错误提示显示为类似Row No 2.price must be a number.的格式，精准对应Excel的实际行号。

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