PHP SimpleXLSX解析XLSX文件异常：需手动操作才可读取完整数据

阿华AIGC实验室

2026-5-28

解决SimpleXLSX读取原始XLSX文件异常的自动化方案

问题分析

你遇到的这个情况其实挺常见的——原始XLSX大概率是由其他系统自动生成的，内部的XML结构存在不规范的地方（比如冗余的空行定义、单元格格式标记异常），而Excel打开保存时会自动修复这些结构问题，所以文件大小翻倍后就能被SimpleXLSX正常读取。手动添加schema没效果，是因为核心问题不在schema定义，而是文件本身的结构缺陷。

自动化解决方案

下面提供几种无需手动操作的方法，按推荐度排序：

方法1：用PhpSpreadsheet预处理XLSX文件

PhpSpreadsheet（PHPExcel的继任者）对不规范XLSX的兼容性更好，可以先加载原始文件，重新保存为标准格式后再用SimpleXLSX读取：

use PhpOffice\PhpSpreadsheet\IOFactory;

function preprocess_xlsx($input_path, $output_path) {
    // 加载原始文件
    $spreadsheet = IOFactory::load($input_path);
    // 重新保存为标准XLSX格式
    $writer = IOFactory::createWriter($spreadsheet, 'Xlsx');
    $writer->save($output_path);
    // 释放内存
    $spreadsheet->disconnectWorksheets();
    unset($spreadsheet);
}

// 使用示例：先预处理，再读取
$original_file = 'path/to/your/downloaded.xlsx';
$processed_file = 'path/to/processed_temp.xlsx';
preprocess_xlsx($original_file, $processed_file);

// 用原有代码读取处理后的文件
if($file = SimpleXLSX::parse($processed_file)) {
    ?><pre><?php print_r($file->rows() ); ?></pre><?php
} else {
    echo SimpleXLSX::parse_error();
}

这个方法能模拟Excel的自动修复逻辑，让文件结构标准化，之后SimpleXLSX就能正常解析了。

方法2：直接用PhpSpreadsheet替代SimpleXLSX

既然PhpSpreadsheet本身就能处理不规范文件，也可以直接用它完成读取、处理、生成CSV的全流程，省去切换库的麻烦：

use PhpOffice\PhpSpreadsheet\IOFactory;

function process_xlsx_to_csv($xlsx_path, $csv_path) {
    $spreadsheet = IOFactory::load($xlsx_path);
    $worksheet = $spreadsheet->getActiveSheet();
    
    // 获取所有有效数据行（自动过滤无效空行）
    $data = $worksheet->toArray(null, true, true, true);
    
    // 生成CSV文件
    $fp = fopen($csv_path, 'w');
    foreach ($data as $row) {
        // 过滤全空的行
        if(array_filter($row)) {
            fputcsv($fp, $row);
        }
    }
    fclose($fp);
    
    $spreadsheet->disconnectWorksheets();
    unset($spreadsheet);
}

// 使用示例
process_xlsx_to_csv('path/to/downloaded.xlsx', 'path/to/output.csv');

这个方案一步到位，不需要依赖SimpleXLSX，兼容性更强。

方法3：手动修复XLSX的XML结构（不推荐）

如果不想引入额外库，可以尝试解压XLSX文件（本质是压缩包），修改工作表的XML文件，移除空行定义和异常单元格标记，但这种方法需要熟悉OOXML结构，维护成本极高，不建议用于生产环境。

额外提示

下载FTP文件时，一定要用二进制模式，避免文件传输过程中损坏：

// FTP二进制下载示例
$ftp_conn = ftp_connect('ftp.example.com');
ftp_login($ftp_conn, 'username', 'password');
ftp_pasv($ftp_conn, true);
ftp_get($ftp_conn, 'local_file.xlsx', 'remote_file.xlsx', FTP_BINARY);
ftp_close($ftp_conn);