Laravel-Excel 导出生成器出现重复行问题的分析与解决

问题现象

在使用 Laravel-Excel 3.1 版本进行数据导出时，开发者遇到了一个奇怪的问题：当使用 Generator 配合 lazy 加载模型查询时，导出的 Excel 文件中会出现重复行。虽然总行数与数据库中的实际记录数一致，但部分真实数据丢失并被重复行替代。

技术背景

Laravel-Excel 是一个强大的 Laravel 数据导入导出包，它提供了多种导出方式：

1. FromQuery 接口：适合直接使用查询构建器
2. FromCollection 接口：适合处理集合数据
3. FromGenerator 接口：适合处理大数据量，使用生成器减少内存消耗

在本案例中，开发者选择了 FromGenerator 接口配合 lazy 加载，理论上这是处理大数据量导出的最佳实践，因为它可以有效地减少内存消耗。

问题代码分析

问题出现在自定义的导出类中，主要结构如下：

class ListExportGenerator implements FromGenerator, WithHeadings, ShouldAutoSize
{
    use Exportable;

    protected $query;

    public function __construct($query)
    {
        $this->query = $query;
    }

    public function generator(): Generator
    {
        foreach ($this->query->lazy(200) as $item) {
            yield [
                $createdAt,
                $updatedAt,
                $this->getStatus(intval($item["status"] ?? "")),
            ];
        }
    }
    
    // 其他方法...
}

可能的原因

1. 生成器上下文问题：PHP 生成器在特定情况下可能会重复 yield 相同的值
2. 查询构建问题：lazy 加载时可能没有正确处理游标位置
3. 数据转换问题：在准备行数据时可能意外修改了原始数据
4. 包内部处理问题：Laravel-Excel 在处理生成器时可能存在缺陷

解决方案探讨

方案一：改用 FromQuery + WithMapping

正如官方成员建议的，使用 FromQuery 接口配合 WithMapping 可能是更稳定的选择：

class ListExport implements FromQuery, WithMapping, WithHeadings, ShouldAutoSize
{
    public function query()
    {
        return $this->query; // 原始查询
    }
    
    public function map($item): array
    {
        return [
            $item->created_at,
            $item->updated_at,
            $this->getStatus($item->status),
        ];
    }
    
    // 其他方法...
}

这种方式的优势在于 Laravel-Excel 内部已经优化了查询的分块处理，虽然不像 lazy 那样显式控制，但同样内存友好。

方案二：使用 FromCollection + prepareRows

开发者实际采用的解决方案是使用 FromCollection 接口并实现 prepareRows 方法：

class ListExport implements FromCollection, WithHeadings, ShouldAutoSize
{
    public function collection()
    {
        return $this->query->get();
    }
    
    public function prepareRows($rows)
    {
        return array_map(function ($item) {
            return [
                $item->created_at,
                $item->updated_at,
                $this->getStatus($item->status),
            ];
        }, $rows);
    }
    
    // 其他方法...
}

这种方法适合数据量不是特别大的情况，因为需要先将所有数据加载到内存中。

最佳实践建议

1. 小数据量：直接使用 FromCollection，代码简单直接
2. 中等数据量：使用 FromQuery + WithMapping，平衡性能和代码复杂度
3. 大数据量：如果必须使用 FromGenerator，确保：
   • 查询构建正确
   • 生成器逻辑没有副作用
   • 测试导出结果是否包含重复数据

深入思考

这个问题的本质在于 PHP 生成器与 Laravel 查询构建器的交互方式。当使用 lazy 加载时，数据库游标管理和生成器的 yield 机制需要完美配合。任何一方的微小错误都可能导致数据重复或丢失。

对于需要精确控制内存使用的大数据量导出场景，建议：

1. 彻底测试生成器输出的每一行数据
2. 考虑实现自定义的分块逻辑
3. 监控实际内存使用情况，确保达到预期效果

总结

Laravel-Excel 提供了多种数据导出方式，各有优缺点。当遇到生成器导出数据重复的问题时，开发者有多种解决方案可选。理解每种方法背后的机制和适用场景，才能选择最适合当前项目需求的方案。对于大多数情况，FromQuery + WithMapping 的组合提供了良好的平衡点，既保持了内存效率，又避免了生成器可能带来的复杂问题。