PhpSpreadsheet中删除列时单元格值异常迁移问题解析

问题现象

在使用PHPOffice/PhpSpreadsheet进行电子表格操作时，开发者发现了一个关于列删除操作的异常行为：当删除某一列且该列右侧相邻列的单元格值为null时，被删除列中的单元格值会异常迁移到右侧原本为null的单元格位置。

具体表现为：

$sheet->fromArray([
    ['a1', 'b1', 'c1', 'd1'],
    ['a2', 'b2', null, 'd2'],
]);
$sheet->removeColumn('B');

执行后预期结果应为：

a1, c1, d1
a2, null, d2

但实际得到的结果却是：

a1, c1, d1
a2, b2, d2

问题根源分析

经过深入分析，这个问题源于PhpSpreadsheet内部对null值单元格的处理机制：

1. fromArray()方法对null值的特殊处理：当使用fromArray()方法填充数据时，如果单元格值为null，默认情况下不会在单元格集合中创建对应的单元格对象。这导致后续操作无法正确识别这些"隐形"的null单元格。

2. 列删除操作的位移逻辑缺陷：在执行removeColumn()操作时，系统需要重新计算所有受影响单元格的位置。由于那些值为null的单元格在内部并未被实际创建，导致位移计算出现偏差，错误地将被删除列的值迁移到了右侧位置。

技术背景

PhpSpreadsheet内部使用单元格集合(CellCollection)来管理所有非空单元格。这种设计原本是为了优化内存使用，避免为大量空值单元格分配内存。然而，这种优化在某些操作场景下会带来副作用：

• 当执行列删除等结构性修改时，系统需要完整的位置映射关系
• 缺失的null单元格会导致位置计算出现偏差
• 最终表现为数据异常迁移

解决方案

目前有以下几种可行的解决方案：

1. 修改fromArray()调用方式：

$sheet->fromArray(
    source: $data,
    nullValue: 'NULL_PLACEHOLDER', // 使用特殊占位符
    strictNullComparison: true     // 启用严格比较
);

2. 调整内部实现逻辑（需要修改源码）：

• 移除fromArray()中对null值的特殊过滤
• 或者在列删除操作时更精确地重建单元格位置关系

3. 手动填充null单元格：

// 在删除列前确保所有单元格都存在
foreach ($sheet->getRowIterator() as $row) {
    for ($col = 'A'; $col <= $highestCol; $col++) {
        $coord = $col.$row->getRowIndex();
        if (!$sheet->cellExists($coord)) {
            $sheet->setCellValue($coord, null);
        }
    }
}

最佳实践建议

对于生产环境中的使用，建议：

1. 始终明确处理null值情况，要么统一使用占位符，要么显式设置null值
2. 在执行结构性修改（如删除行列）前，先检查并补齐缺失的单元格
3. 考虑封装自定义的Sheet操作类，统一处理这些边界情况

这个问题揭示了在电子表格库设计中，内存优化与功能完整性之间的权衡。开发者需要根据具体使用场景，选择最适合的处理方式。