NodeJS：本地写入文件后如何上传至云存储？

问题原因分析 #

• storage.bucket("bucketName").file("bucketFileName").save("./public/fileName.xlsx") 会将传入的路径字符串直接作为文件内容写入，而非读取本地文件的实际内容，这就是你看到上传文件内容为路径的原因。
• bucket.upload 无效果通常是因为异步操作未正确处理、存储桶配置/权限问题，或是文件路径/桶名错误。

方法一：使用 bucket.upload（推荐） #

这是云存储SDK提供的便捷上传方法，直接传入本地文件路径即可，需注意处理异步逻辑：

const { Storage } = require('@google-cloud/storage'); // 以Google Cloud Storage为例，其他厂商SDK逻辑类似
const storage = new Storage();
const bucketName = '你的存储桶名称';
const localFilePath = './public/fileName.xlsx';
const destFileName = 'bucketFileName.xlsx';

// 用async/await处理异步上传
async function uploadExcel() {
  try {
    await storage.bucket(bucketName).upload(localFilePath, {
      destination: destFileName,
      // 可选：设置文件MIME类型，确保云存储识别为Excel文件
      metadata: {
        contentType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
      },
    });
    console.log(`${localFilePath} 已成功上传至 ${bucketName}/${destFileName}`);
  } catch (err) {
    console.error('上传失败:', err);
  }
}

uploadExcel();

如果之前bucket.upload无效果，检查以下几点：

• 确认云存储的认证配置正确（如密钥文件、环境变量）
• 核实存储桶名称正确且已存在
• 确保本地文件路径无误，文件存在且程序有读取权限
• 代码中是否遗漏了await（或未正确处理回调）导致异步操作未执行完成

方法二：手动读取文件内容后上传 #

若需更灵活的控制，可先读取本地文件内容，再写入云存储：

同步读取文件内容（适合小文件）

const { Storage } = require('@google-cloud/storage');
const fs = require('fs');
const storage = new Storage();
const bucketName = '你的存储桶名称';
const localFilePath = './public/fileName.xlsx';
const destFileName = 'bucketFileName.xlsx';

async function uploadExcel() {
  try {
    // 读取本地文件的二进制内容
    const fileContent = fs.readFileSync(localFilePath);
    const cloudFile = storage.bucket(bucketName).file(destFileName);
    
    await cloudFile.save(fileContent, {
      metadata: {
        contentType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
      },
    });
    console.log(`${localFilePath} 上传成功`);
  } catch (err) {
    console.error('上传失败:', err);
  }
}

uploadExcel();

流式上传（适合大文件）

const { Storage } = require('@google-cloud/storage');
const fs = require('fs');
const storage = new Storage();
const bucketName = '你的存储桶名称';
const localFilePath = './public/fileName.xlsx';
const destFileName = 'bucketFileName.xlsx';

function uploadExcel() {
  return new Promise((resolve, reject) => {
    const readStream = fs.createReadStream(localFilePath);
    const writeStream = storage.bucket(bucketName).file(destFileName).createWriteStream({
      metadata: {
        contentType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
      },
    });

    readStream.pipe(writeStream);

    writeStream.on('finish', () => {
      console.log('文件上传完成');
      resolve();
    });

    writeStream.on('error', (err) => {
      console.error('上传出错:', err);
      reject(err);
    });
  });
}

uploadExcel();

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