Node.js中fs.createWriteStream带路径前缀写入失败问题求助

调用API遍历图片数组，为每张图片分配唯一名称后写入本地./img目录，已手动创建img子目录，但使用fs.createWriteStream拼接./img路径前缀时无法写入文件，仅直接写入根目录可成功。尝试将路径拼接移至forEach的函数调用中，也排查过__dirname和权限问题，但未出现任何报错，需要解决该问题。

相关代码 #

const imageFolder = './img';

function downloadImage(url, filepath) {
    client.get(url, res => {
        res.pipe(fs.createWriteStream(`${imageFolder}/${filepath}`));
    });
}

// ...调用API的代码

const imagesArray = generations.data.map(item => item.generation.image_path);

imagesArray.forEach(item => {
    // const fileName = uuid.v4() + '.webp'; // 尝试用uuid生成唯一文件名
    const fileName = new Date().getTime().toString() + '.webp'; // 尝试用时间戳生成唯一文件名
    downloadImage(item, fileName);
});

解决方案 #

• 使用绝对路径避免歧义
  相对路径可能因当前工作目录与脚本所在目录不一致导致问题，用path.resolve生成绝对路径：

  const path = require('path');
  const imageFolder = path.resolve(__dirname, './img');
  

• 添加错误监听捕获隐藏问题
  原代码未监听流的错误事件，可能出错但无提示，补上错误监听：

  function downloadImage(url, filepath) {
      client.get(url, res => {
          const writeStream = fs.createWriteStream(path.join(imageFolder, filepath));
          res.pipe(writeStream);
          
          writeStream.on('error', (err) => {
              console.error('写入文件错误:', err);
          });
          
          res.on('error', (err) => {
              console.error('请求图片错误:', err);
          });
      });
  }
  

• 用path.join做路径拼接
  代替字符串拼接，自动适配不同系统的路径分隔符：

  // 替换原字符串拼接为path.join
  const writeStream = fs.createWriteStream(path.join(imageFolder, filepath));
  

• 确保目录存在
  即使手动创建了目录，也可在代码中校验并自动创建（防止手动操作失误）：

  const fs = require('fs').promises;
  
  async function ensureFolderExists() {
      try {
          await fs.access(imageFolder);
      } catch {
          await fs.mkdir(imageFolder, { recursive: true });
      }
  }
  
  // 先确保目录存在再开始下载
  ensureFolderExists().then(() => {
      imagesArray.forEach(item => {
          const fileName = new Date().getTime().toString() + '.webp';
          downloadImage(item, fileName);
      });
  });
  

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