Node.js上传XLS文件至Linux环境时文件为空问题求助

刚踩过类似的跨平台文件上传坑，你的问题大概率是Windows和Linux的文件系统差异或者文件权限/路径问题导致的，下面给你几个针对性的解决方案：

1. 先排查文件路径问题（最常见原因） #

Windows用\作为路径分隔符，而Linux用/，硬编码的路径在跨平台时会直接失效，导致读取不到文件，自然上传为空。

解决方法：用Node.js内置的path模块生成跨平台兼容的路径，不要硬写分隔符：

const path = require('path');
// 用__dirname确保基于当前脚本所在目录找文件，避免工作目录差异
const filePath = path.join(__dirname, 'your-excel-file.xls');

2. 检查Linux下的文件读取权限 #

Linux的文件权限管控比Windows严格，如果你运行Node进程的用户没有该XLS文件的读取权限，也会导致读取到空内容。

• 先确认文件存在：在Linux终端执行ls -l /path/to/your/file.xls
• 如果权限不足，执行chmod 644 /path/to/your/file.xls给文件添加读权限（生产环境按需调整权限）

3. 优化表单上传的流处理 #

有时候Linux下文件流的读取时机和Windows略有差异，建议给form.append明确指定文件名和Content-Type，避免自动检测出错：

form.append('file', fs.createReadStream(filePath), {
  filename: 'your-excel-file.xls', // 明确指定文件名
  contentType: 'application/vnd.ms-excel' // XLS文件的标准MIME类型
});

4. 额外建议：添加文件存在性校验 #

在上传前先检查文件是否可读，能快速定位问题：

fs.access(filePath, fs.constants.R_OK, (err) => {
  if (err) {
    console.error('文件不可读或不存在:', err.message);
    return;
  }
  // 这里再执行上传逻辑
});

修改后的完整代码示例 #

const fs = require('fs');
const path = require('path');
const request = require('request');

// 注意：禁用TLS校验（NODE_TLS_REJECT_UNAUTHORIZED=0）非常不安全，生产环境请配置合法的CA证书
process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";

const base_url = "你的API基础地址";
const filePath = path.join(__dirname, 'your-excel-file.xls');

// 先校验文件可用性
fs.access(filePath, fs.constants.R_OK, (err) => {
  if (err) {
    console.error('前置校验失败:', err);
    return;
  }

  const req = request.post(`${base_url}/api/livraison/import-api`, (err, resp, body) => {
    if (err) {
      console.log('上传出错:', err);
    } else {
      console.log('返回内容:', body);
      console.log('Import COMPLETED');
    }
  });

  const form = req.form();
  form.append('file', fs.createReadStream(filePath), {
    filename: 'your-excel-file.xls',
    contentType: 'application/vnd.ms-excel'
  });
});

另外提一句：如果你的文件是XLSX格式，要把Content-Type改成application/vnd.openxmlformats-officedocument.spreadsheetml.sheet哦。

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