PhpSpreadsheet 中删除并重新添加工作表时的索引越界问题解析

问题现象

在使用 PhpSpreadsheet 2.2 版本时，开发者可能会遇到一个特定的异常情况：当尝试创建一个新的电子表格，删除默认工作表，然后添加自定义工作表并设置单元格值时，系统会抛出"Your requested sheet index: -1 is out of bounds"的错误。

问题重现

以下代码可以重现这个问题：

$mySpreadsheet = new Spreadsheet();
$mySpreadsheet->removeSheetByIndex(0); // 删除默认工作表
$worksheet = new Worksheet($mySpreadsheet, 'Insured List');
$mySpreadsheet->addSheet($worksheet, 0); // 显式指定索引0添加新工作表
$row = 1;
$col = 1;
$worksheet->getCell([$col, $row])->setValue('id_uti'); // 这里会抛出异常

问题根源

这个问题的根本原因在于 PhpSpreadsheet 2.2 版本中的一个内部状态管理问题。当执行以下操作序列时：

1. 创建新电子表格（默认包含一个工作表）
2. 删除唯一的工作表
3. 添加新工作表时显式指定索引0

此时电子表格对象的"活动工作表"索引没有被正确更新，导致后续操作时系统尝试访问一个不存在的活动工作表索引（-1）。

解决方案

开发者可以采用以下两种方式解决这个问题：

方案一：不指定工作表索引

最简单的解决方法是让 addSheet 方法自动处理工作表索引：

$mySpreadsheet->addSheet($worksheet); // 不指定索引

这种方式下，当电子表格中没有其他工作表时，新添加的工作表会自动成为活动工作表。

方案二：显式设置活动工作表

如果确实需要指定工作表索引，可以在添加工作表后显式设置活动工作表：

$mySpreadsheet->addSheet($worksheet, 0);
$mySpreadsheet->setActiveSheetIndex(0); // 显式设置活动工作表

最佳实践建议

1. 避免不必要的索引操作：除非有特殊需求，否则让 PhpSpreadsheet 自动管理工作表索引通常是最安全的选择。

2. 状态检查：在删除或添加工作表后，可以使用 getSheetCount() 方法检查当前工作表数量，确保操作符合预期。

3. 异常处理：对可能抛出异常的操作（如工作表索引操作）进行适当的异常捕获和处理。

4. 版本适配：这个问题在 PhpSpreadsheet 2.2 中出现，后续版本可能会修复，开发者应注意版本更新。

总结

这个问题展示了电子表格库中状态管理的重要性。开发者在操作工作表时，应当注意内部状态的连贯性，特别是在执行删除和添加工作表的组合操作时。理解库的内部工作机制有助于编写更健壮的代码，避免类似的边界条件问题。