NodeJS HTTPS请求报错connect ECONNREFUSED 127.0.0.1:443咨询

问题概述 #

我写了这段代码想从外部URL加载图片：

var https = require('node:https');

export const loadImageFromUrl = (url: string) => {
  return new Promise((resolve, reject) => {
    try {
      https.request(url, function (response: any) {
        resolve(response);
      });
    } catch (err) {
      reject(err);
    }
  });
};

但加载https://en.pimg.jp/054/313/779/1/54313779.jpg时，抛出了错误：

Error: connect ECONNREFUSED 127.0.0.1:443

目标URL明明是外部地址，为什么请求会连到本地的127.0.0.1:443？

原因排查 #

1. 异步错误未被捕获：try/catch只能捕获同步错误，https.request是异步API，它的错误会通过请求对象的error事件触发，外层的try/catch根本抓不到，导致错误直接暴露为全局异常。
2. 代理配置出错：如果你的系统或Node.js环境里设置了HTTPS_PROXY/https_proxy环境变量，且值是https://127.0.0.1:443，Node.js会自动把所有HTTPS请求转发到这个代理地址，而本地没运行代理服务，就会出现连接拒绝。
3. 请求未实际发送：代码里仅创建了请求对象，但没调用req.end()，这会导致请求无法发起，虽不会直接引发连接本地的错误，但也是代码的关键缺陷。

解决办法 #

1. 正确捕获异步错误并处理响应数据 #

修改代码，给请求对象添加error监听器，同时收集图片的二进制数据（原代码直接返回response对象无法获取图片内容）：

var https = require('node:https');

export const loadImageFromUrl = (url: string) => {
  return new Promise((resolve, reject) => {
    const req = https.request(url, (response) => {
      const chunks: Buffer[] = [];
      // 分段收集响应数据
      response.on('data', (chunk) => chunks.push(chunk));
      // 数据接收完成后合并为Buffer返回
      response.on('end', () => resolve(Buffer.concat(chunks)));
    });

    // 捕获请求过程中的错误
    req.on('error', reject);
    // 发起请求
    req.end();
  });
};

2. 检查并修正代理配置 #

• 查看系统环境变量中的HTTPS_PROXY/https_proxy，如果是错误的本地代理地址，直接删除或替换为正确的代理地址。
• 如果不需要代理，可以在请求选项里显式禁用：

const req = https.request(new URL(url), {
  agent: new https.Agent({ proxy: false })
}, (response) => {
  // 响应处理逻辑
});

3. 显式解析URL避免格式问题 #

用new URL(url)解析目标地址，确保Node.js能正确识别主机和路径，避免因URL解析错误导致的异常：

const urlObj = new URL(url);
const req = https.request(urlObj, (response) => {
  // 处理响应逻辑
});

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