Node.js检测文件不存在时下载文件生成0字节问题排查

首先咱们先揪出两个核心问题，帮你把空文件和逻辑错位的问题解决掉：

1. 下载逻辑放在catch块的误区 #

catch是用来捕获Promise链中的异常的，比如getApiDetails请求失败、文件检测时出现权限错误这类意外情况才会进入这里。但你的需求是「文件不存在时下载」，这并不是一个异常（或者说你应该主动判断文件不存在的分支，而不是靠catch来触发）。把下载逻辑丢在catch里，要么是触发时机完全不对，要么是把「文件不存在」和其他错误混为一谈，导致下载逻辑执行的条件根本不符合预期。

2. 文件0字节的常见原因 #

下载的文件是空字节，大概率是你没正确处理文件写入的流操作：

• 没有等待文件流写入完成就结束了进程
• HTTP请求的响应流没有正确pipe到文件流
• 请求URL出错（比如返回404）但没处理错误，导致空内容被写入

修复后的示例代码 #

下面是调整后的完整逻辑，我标注了关键要点：

const fs = require('fs').promises;
const fsSync = require('fs');
const path = require('path');
const https = require('https'); // 如果是HTTP地址就换成http模块

getApiDetails.then(async (apiData) => {
  const imagesFolder = 'public/city_images/';
  // 先确保目标文件夹存在，避免写入时抛错
  await fs.mkdir(imagesFolder, { recursive: true });

  // 假设apiData里包含图片URL和要保存的文件名
  const imageUrl = apiData.imageUrl;
  const filename = path.join(imagesFolder, apiData.filename);

  try {
    // 检测文件是否存在
    await fs.access(filename);
    console.log(`文件 ${filename} 已存在，跳过下载`);
  } catch (err) {
    // 这里的catch才对应「文件不存在」的情况（access检测失败）
    console.log(`文件 ${filename} 不存在，开始下载...`);
    await downloadFile(imageUrl, filename);
    console.log(`文件 ${filename} 下载完成`);
  }
}).catch(err => {
  // 专门处理getApiDetails本身的错误，比如API请求失败
  console.error('获取API数据失败:', err);
});

// 封装可靠的下载函数
function downloadFile(url, dest) {
  return new Promise((resolve, reject) => {
    const fileStream = fsSync.createWriteStream(dest);
    
    const request = https.get(url, (response) => {
      // 先检查HTTP状态码，避免把404/500这类错误响应写入文件
      if (response.statusCode !== 200) {
        reject(new Error(`请求失败，状态码：${response.statusCode}`));
        fileStream.close();
        return;
      }

      // 将响应流pipe到文件流
      response.pipe(fileStream);
    });

    // 监听文件流写入完成的事件
    fileStream.on('finish', resolve);
    // 处理文件流写入错误，出错时删除空文件
    fileStream.on('error', (err) => {
      fsSync.unlink(dest, () => {}); 
      reject(err);
    });

    // 处理请求本身的错误，比如网络问题
    request.on('error', (err) => {
      fsSync.unlink(dest, () => {}); 
      reject(err);
    });
  });
}

关键修复点说明 #

• 调整逻辑分支：用fs.promises.access主动检测文件存在，只有当检测失败（文件不存在）时，才在对应的catch块里执行下载，这才是符合需求的正确逻辑。
• 封装可靠的下载函数：
  • 用Promise包裹流操作，确保可以用await等待下载完成
  • 检查HTTP响应状态码，避免把无效内容写入文件
  • 监听流的finish和error事件，异常时自动删除空文件
  • 同时捕获请求和文件流的错误，避免静默失败导致空文件残留

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