Node.js中Multer上传文件至云端后无法访问问题排查

问题根源分析 #

你遇到的云端文件访问失败问题，核心原因是**fs.readFileSync读取文件时的编码设置错误**，咱们一步步拆解：

1. 错误的编码格式：你用utf8编码读取本地临时文件，但图片、视频、文档这类二进制文件不能用文本编码读取——这会把原始二进制数据强制转换成字符串，彻底破坏文件的字节结构，上传到云端后自然无法正常解析。
2. 同步方法的误用：fs.readFileSync是同步方法，它根本不接受回调函数，你写的(error, buffer) => ({ error, buffer })完全不会被执行，所以fileBuffer其实是一段被损坏的字符串（而非原始Buffer），这直接导致上传的文件无效。

修正后的云端上传代码 #

const putFile = async (file) => {
  const auth = await getAuthToken();
  const formData = new FormData();
  
  try {
    // 1. 去掉utf8编码，默认读取原始二进制Buffer
    const fileBuffer = fs.readFileSync(file.path);
    
    // 2. 给FormData传入完整文件信息，帮助云端识别文件类型
    formData.append('file', fileBuffer, {
      filename: file.filename,
      contentType: file.mimetype
    });
    
    await axios.put(auth['x-storage-url'], formData, {
      headers: {
        'X-Auth-Token': auth['x-auth-token'],
        ...formData.getHeaders()
      }
    });
    
    // 3. 拼接正确的文件访问URL
    file.src = `${auth['x-storage-url']}/${file.filename}`;
    // 4. 同步删除本地临时文件，避免异步操作遗漏清理
    fs.unlinkSync(file.path);
    
    return file;
  } catch (e) {
    // 出错时也尝试清理临时文件，避免磁盘占用
    try {
      fs.unlinkSync(file.path);
    } catch (cleanupErr) {
      console.error('Failed to cleanup temp file:', cleanupErr.message);
    }
    throw new Error(`Upload failed: ${e.message}`);
  }
};

额外优化说明 #

• 同步清理临时文件：把原来的异步fs.unlink改成fs.unlinkSync，确保文件上传完成（或失败）后，本地临时文件能被及时清理，避免服务器磁盘被无用文件占满。
• 明确文件类型：在formData.append时传入contentType，让云端能正确识别文件的MIME类型，避免访问时出现“无法识别文件格式”的问题。
• 错误链路的完整性：在catch块中添加临时文件清理逻辑，即使上传失败，也不会留下垃圾文件。

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