PhpSpreadsheet本地正常，服务器导出Excel报错mb_strlen未定义

核心错误原因 #

PHP Fatal error: Uncaught Error: Call to undefined function PhpOffice\PhpSpreadsheet\Shared\mb_strlen()

这个错误明确说明服务器的PHP环境未启用mbstring扩展——PhpSpreadsheet依赖该扩展处理多字节字符串操作，你的本地环境默认开启了该扩展，但服务器配置中未启用。

第一步：启用mbstring扩展 #

• 确认扩展状态：创建一个phpinfo.php文件，内容为<?php phpinfo(); ?>，访问后搜索mbstring，无结果则表示未安装/启用。
• 启用方式：
  • 独立服务器/VPS：编辑PHP配置文件php.ini，找到;extension=mbstring（Windows环境为;extension=php_mbstring.dll），去掉行首的分号，保存后重启Web服务（Apache/Nginx+PHP-FPM）。
  • 共享主机：联系主机服务商要求开启mbstring扩展，部分主机支持通过控制面板（如cPanel）自行启用。

第二步：优化代码避免其他潜在问题 #

除了扩展问题，你的代码还有几个可能导致下载失败的隐患，建议调整：

1. 修正Content-Type：根据导出文件类型设置正确的MIME类型，替换原错误的application/x-www-form-urlencoded：

   • XLSX文件：application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
   • XLS文件：application/vnd.ms-excel
   • CSV文件：text/csv

2. 直接输出到浏览器，避免服务器文件读写：无需先保存文件到服务器再读取删除，直接输出到php://output，避免权限问题：

优化后的核心代码片段：

ob_clean();
ob_start(); // 确保输出缓冲区干净

// 验证文件类型合法性
$allowedTypes = ['Xlsx', 'Xls', 'Csv'];
if(!in_array($_POST["file_type"], $allowedTypes)){
    die('Invalid file type');
}

$writer = \PhpOffice\PhpSpreadsheet\IOFactory::createWriter($file, $_POST["file_type"]);
$file_name = 'Competitor Insights.' . strtolower($_POST["file_type"]);

// 匹配对应MIME类型
$mimeTypes = [
    'Xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
    'Xls' => 'application/vnd.ms-excel',
    'Csv' => 'text/csv'
];
$contentType = $mimeTypes[$_POST["file_type"]] ?? 'application/octet-stream';

header('Content-Type: ' . $contentType);
header('Content-Transfer-Encoding: Binary');
header("Content-disposition: attachment; filename=\"" . $file_name . "\"");

// 直接输出到浏览器
$writer->save('php://output');
exit;

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