Node.js、Express与SheetJS实现的XLSX文件导出功能在Linux服务器出现下载冻结无法完成问题

我来帮你拆解下这个跨平台的问题，这类环境差异导致的问题我之前也碰到过几次，咱们一步步理清楚：

一、使用buffer类型时Linux下载冻结的原因 #

Windows正常但Linux下载卡住，核心问题基本出在路径处理、文件权限或者静态服务配置上：

1. 路径兼容性问题：如果生成resolvedFilename时是手动拼接路径（不是用path.join），Windows和Linux的路径分隔符差异（\ vs /）可能导致实际写入的目录结构异常，比如Linux下生成了错误的嵌套路径，静态服务找不到文件，请求就一直挂着。
2. 文件/目录权限不足：Linux下Node.js进程运行的用户，可能没有读取生成文件的权限，或者downloads目录没有创建权限。比如文件生成后权限是600，而Express运行用户不是文件所有者，就会读取失败，导致下载请求卡住。
3. 静态服务配置问题：如果你的express.static没有用绝对路径映射public目录，Linux下可能因为工作目录不同，找不到下载文件的位置，请求一直处于等待状态。

二、使用binary类型时文件损坏的原因 #

SheetJS的type: 'binary'返回的是原始字节的UTF-8字符串表示，而fs.writeFileSync默认用UTF-8编码写入文件，这会把字节字符串转成UTF-8字符，直接破坏了xlsx文件的二进制结构，所以Excel会提示文件损坏。

具体解决建议 #

针对buffer类型的问题（推荐方案，buffer是最可靠的二进制处理方式） #

1. 用path.join严格处理路径：
   生成文件路径时一定要用Node.js的path.join拼接，保证跨平台兼容性，同时提前创建不存在的目录：

   const resolvedFilename = path.join(__dirname, 'public', 'downloads', date, filename);
   // 递归创建所需目录（如果不存在）
   fs.mkdirSync(path.dirname(resolvedFilename), { recursive: true });
   

2. 设置正确的文件权限：
   写入文件后，给文件和目录设置合适的权限，确保Express进程能读取：

   fs.writeFileSync(resolvedFilename, buf);
   // 设置文件权限为644（所有者读写，其他只读）
   fs.chmodSync(resolvedFilename, 0o644);
   // 确保上级目录权限为755
   fs.chmodSync(path.dirname(resolvedFilename), 0o755);
   

3. 检查静态服务配置：
   用绝对路径配置静态服务，避免工作目录的影响：

   app.use('/public', express.static(path.join(__dirname, 'public')));
   

4. 改用异步写入（可选）：
   同步写入fs.writeFileSync在高并发场景下可能阻塞事件循环，改用异步版本更稳妥：

   await fs.promises.writeFile(resolvedFilename, buf);
   

针对binary类型的问题（如果一定要用这种方式） #

需要把SheetJS返回的binary字符串转换成正确的Buffer后再写入，这样就能保留原始二进制数据：

const binaryStr = XLSX.write(workbook, { bookType: 'xlsx', type: 'binary' });
const buf = Buffer.from(binaryStr, 'binary'); // 指定编码为binary来转换
fs.writeFileSync(resolvedFilename, buf);

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