TypeScript实现Zip文件下载后文件损坏问题求助

核心问题：未处理HTTP重定向 #

你遇到的文件损坏问题，大概率是因为目标服务器返回了HTTP重定向（3xx状态码），而https.get默认不会自动跟随重定向，导致你下载的是重定向跳转页面的HTML内容，而非实际的ZIP文件——虽然文件大小看起来接近，但本质是文本文件，自然无法被识别为ZIP格式。

验证方式 #

可以先在代码里打印响应的状态码和头部信息，确认是否存在重定向：

import fs from 'fs';
import https from 'https';

export function handler(): void {
  https.get('https://data.humdata.org/dataset/3f976f27-2566-4ea7-b29e-7fc6ebc90aab/resource/060abaf3-8c9f-4df4-b7e3-5335a15c6247/download/world_port_index.zip', (res) => {
    console.log('状态码:', res.statusCode);
    console.log('响应头:', res.headers);
    res.pipe(fs.createWriteStream("./wpi.zip"));
  });
}

如果输出的状态码是301/302，且location字段指向另一个URL，就坐实了重定向问题。

修正后的代码 #

以下代码会自动处理重定向，同时监听流的完成与错误事件，确保文件完整写入：

import fs from 'fs';
import https from 'https';
import { URL } from 'url';

export function handler(): void {
  const downloadUrl = 'https://data.humdata.org/dataset/3f976f27-2566-4ea7-b29e-7fc6ebc90aab/resource/060abaf3-8c9f-4df4-b7e3-5335a15c6247/download/world_port_index.zip';

  const downloadFile = (url: string) => {
    https.get(url, (res) => {
      // 处理重定向
      if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
        const redirectUrl = new URL(res.headers.location, url).toString();
        console.log('跟随重定向到:', redirectUrl);
        downloadFile(redirectUrl);
        return;
      }

      // 创建写入流并监听事件
      const writeStream = fs.createWriteStream("./wpi.zip");
      res.pipe(writeStream);

      // 文件写入完成事件
      writeStream.on('finish', () => {
        console.log('文件下载完成');
        writeStream.close();
      });

      // 捕获流错误
      writeStream.on('error', (err) => {
        console.error('写入文件出错:', err);
        fs.unlinkSync("./wpi.zip"); // 删除损坏的文件
      });
    }).on('error', (err) => {
      console.error('请求出错:', err);
    });
  };

  downloadFile(downloadUrl);
}

其他注意事项 #

• 不需要设置编码：ZIP是二进制文件，https.get返回的流默认就是二进制格式，手动设置编码反而会导致文件损坏。
• 监听错误事件：之前的代码没有捕获任何错误，下载过程中如果出现网络问题，只会静默失败，增加错误监听可以帮你快速定位问题。

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