https.request返回完整数据，管道写入文件时内容开头缺失

你遇到的问题核心在于请求工具函数的事件监听逻辑冲突：不管是否开启stream模式，代码都会给响应流res绑定data事件来拼接data变量。而Node.js的可读流有个特性——一旦添加data事件监听，就会立刻进入流动模式，开始发射数据。

当你以stream: true调用函数时，虽然立刻resolve了响应流res，但此时data事件已经在悄悄消费部分数据了。等到你后续调用pipe写入文件时，这部分已经被消费的数据不会再流入写入流，自然就出现了文件开头缺失的情况。哪怕把resolve(res)移到req.on("end")里也没用，因为响应流的data事件早就开始触发了。

解决办法：分模式隔离事件监听 #

修改工具函数，仅在非stream模式下绑定data和end事件来拼接数据，stream模式下只返回响应流，避免多余的事件监听触发数据消费：

import client from "https";

const _request = (url, options, timeout) => {
    const httpOptions = {};
    const parsedUrl = new URL(url);

    httpOptions.hostname = parsedUrl.hostname;
    httpOptions.port = parsedUrl.port;
    httpOptions.path = parsedUrl.pathname + parsedUrl.search;
    httpOptions.method = (options.method?.toUpperCase()) || "GET";

    return new Promise((resolve, reject) => {
        const req = client.request(httpOptions, (res) => {
            // Stream模式：直接返回响应流，仅绑定error事件避免未处理异常
            if (options.stream === true) {
                res.on("error", reject);
                return resolve(res);
            }

            // 非Stream模式：绑定事件拼接响应数据
            let data = '';
            res.on("data", (chunk) => {
                data += chunk;
            });

            res.on("end", () => {
                resolve({
                    status: res.statusCode,
                    statusText: res.statusMessage,
                    data: data,
                });
            });

            res.on("error", reject);
        });

        // 监听请求阶段的错误
        req.on("error", reject);
        // 处理超时逻辑
        if (timeout) {
            req.setTimeout(timeout, () => {
                req.destroy(new Error("Request timeout"));
            });
        }

        req.end();
    });
};

额外优化点 #

• 给请求对象req也绑定了error事件，避免请求发起阶段的错误未被捕获导致Promise挂起
• 补全了timeout参数的实际逻辑，让函数参数更有用

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