云函数临时下载云存储文件失败，返回空数组求助

核心误解：download方法返回空数组是正常行为 #

当调用download时指定了destination参数，方法会直接将文件写入你指定的本地路径，不会返回文件内容数组，所以打印file得到[]是符合API设计的预期结果，不是错误。你需要通过检查目标路径的文件是否存在来验证下载是否成功，而不是依赖返回值。

关键修复点 #

1. 修正临时文件路径 #

云函数的执行环境中，只有/tmp目录是可写的临时存储，不要通过__dirname拼接路径，直接使用/tmp作为目标路径：

const destFileName = '/tmp/mytest.jpg'; // 直接使用系统临时目录

2. 验证文件是否下载成功 #

在download之后，通过文件系统API检查文件状态：

const fs = require('fs').promises;

// 下载完成后检查文件
await storage.bucket(bucketName).file(fileName).download({ destination: destFileName });
const stats = await fs.stat(destFileName);
console.log('文件大小:', stats.size); // 如果大于0则说明下载成功

3. 流方式的正确实现 #

如果用createReadStream/createWriteStream，推荐使用stream/promises的pipeline方法来处理流，确保异步操作完成：

const fs = require('fs');
const { pipeline } = require('stream/promises');

await pipeline(
  storage.bucket(bucketName).file(fileName).createReadStream(),
  fs.createWriteStream('/tmp/mytest.jpg')
);
// pipeline完成后文件已写入完成

4. 确保异步操作全部完成再返回响应 #

云函数中必须等待所有异步操作（下载、PDF生成等）完成后再发送响应，否则进程可能提前终止导致文件写入不完整：

// 所有操作完成后再返回
res.status(200).send('PDF生成完成');

完整修正后的代码片段 #

const functions = require('@google-cloud/functions-framework');
const { Storage } = require('@google-cloud/storage');
const fs = require('fs').promises;

const storage = new Storage(); // 确保初始化Storage实例

functions.http('<my func>', async (req, res) => {
  try {
    const bucketName = '<my bucket>';
    const fileName = 'mytest.jpg';
    const destFileName = '/tmp/mytest.jpg'; // 直接使用/tmp目录

    // 验证文件元数据（确认文件存在）
    const [meta] = await storage.bucket(bucketName).file(fileName).getMetadata();
    console.log('文件元数据:', meta);

    // 下载文件到临时目录
    await storage.bucket(bucketName).file(fileName).download({ destination: destFileName });

    // 检查文件是否下载成功
    const stats = await fs.stat(destFileName);
    if (stats.size === 0) {
      throw new Error('下载的文件为空');
    }
    console.log('文件下载成功，大小:', stats.size);

    // 后续PDF生成逻辑...

    res.status(200).send('操作完成');
  } catch (err) {
    console.error('错误:', err);
    res.status(500).send(err.message);
  }
});

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