Symfony用PhpSpreadsheet导入CSV报Failed to store cell in cache错误怎么解决

• PhpSpreadsheet本身是为处理Excel(xls/xlsx)格式设计的，解析CSV的性能非常差，默认会将所有单元格实例化存储，6.5万行+多列的场景下会产生海量缓存文件，触发文件系统限制或IO瓶颈
• 当前使用的FilesystemAdapter缓存会生成大量小缓存文件，要么是预发布服务器的缓存目录权限不足、磁盘配额不够，要么是缓存写入速度跟不上解析速度触发报错
• 直接调用toArray()方法会把整个表格内容一次性加载到内存，内存占用随文件大小线性增长，同时如果逐行写入数据库会产生大量IO请求，是资源占用高、运行极慢的核心原因

分两种场景适配：

场景1：必须保留PhpSpreadsheet的优化方案 #

• 调整缓存驱动：优先替换成RedisAdapter作为缓存存储，性能比文件缓存高10倍以上，也不会产生海量小文件触发系统限制；如果无法使用Redis，先调整服务器PHP配置，调高memory_limit、open_files_limit参数，检查缓存目录的写入权限和磁盘配额
• 开启读筛选，只加载需要用到的列，跳过无用列：

$reader = IOFactory::createReader('Csv');
// 自定义读过滤器，只加载需要的列
$reader->setReadFilter(new class implements \PhpOffice\PhpSpreadsheet\Reader\IReadFilter {
    public function readCell($columnAddress, $row, $worksheetName = '') {
        // 示例仅读取A到Z列，可按需调整范围
        return ord($columnAddress) <= ord('Z');
    }
});
$spreadSheet = $reader->load($csvPath);

• 逐行读取代替一次性toArray()，处理过程中及时释放内存：

$worksheet = $spreadSheet->getActiveSheet();
$maxRow = $worksheet->getHighestRow();
$maxCol = $worksheet->getHighestColumn();
for ($row = 1; $row <= $maxRow; $row++) {
    $rowData = $worksheet->rangeToArray("A{$row}:{$maxCol}{$row}")[0];
    // 处理行数据、写入数据库逻辑
    unset($rowData);
    // 每处理1000行执行一次垃圾回收
    if ($row % 1000 === 0) {
        $spreadSheet->garbageCollect();
    }
}

• 每个CSV处理完成后立刻销毁对象、清空缓存：

// 单文件处理完成后执行
unset($spreadSheet);
$simpleCache->clear();

• 运行命令时加上--no-debug参数关闭调试模式，减少额外内存占用。

场景2：替换为CSV专用解析方案（优先推荐，性能提升至少100倍） #

完全不需要用PhpSpreadsheet处理CSV，使用PHP原生CSV处理函数即可，内存占用稳定在几MB，不会有缓存问题，也能大幅提升处理速度：

// 原生PHP逐行读取+批量写入数据库示例
$handle = fopen($csvPath, 'r');
// 读取CSV表头
$headers = fgetcsv($handle);
$batch = [];
$batchSize = 1000; // 批量写入减少数据库IO请求
while (($row = fgetcsv($handle)) !== false) {
    // 组装数据格式
    $batch[] = array_combine($headers, $row);
    if (count($batch) === $batchSize) {
        // 批量写入数据库
        $entityManager->flush();
        $entityManager->clear();
        $batch = [];
    }
}
// 写入最后一批剩余数据
if (!empty($batch)) {
    $entityManager->flush();
    $entityManager->clear();
}
fclose($handle);

该方案下处理6.5万行CSV仅需几十秒，完全不会出现本地运行3天、服务器缓存报错的问题。

内容的提问来源于stack exchange，提问作者Ahmed Kallali