如何区分Node.js HTTPS请求错误是代理故障还是目标主机不可达

两种场景报错一致的核心原因是socks-proxy-agent默认将代理连接、目标地址连接两个阶段的超时错误统一抛出，没有做阶段标记，拆分两个阶段的校验即可解决问题：

方案1：前置代理连通性检测 #

先单独校验代理的端口连通性，再发起实际业务请求，根据预检测结果即可直接定位报错原因，实现逻辑如下：

const net = require('net');
const url = require('url');
const https = require('https');
const SocksProxyAgent = require('socks-proxy-agent');

// 代理连通性检测函数
function checkProxyAlive(proxyHost, proxyPort, timeout = 2000) {
  return new Promise((resolve) => {
    const socket = net.connect(proxyPort, proxyHost, () => {
      socket.end();
      resolve(true); // 代理端口可连通
    });
    socket.setTimeout(timeout, () => {
      socket.destroy();
      resolve(false); // 代理连接超时
    });
    socket.on('error', () => {
      resolve(false); // 代理连接报错
    });
  });
}

// 业务请求逻辑
async function runRequest() {
  const proxyUrl = new URL("socks4://works.local:1080");
  // 先检测代理可用性
  const isProxyAlive = await checkProxyAlive(proxyUrl.hostname, proxyUrl.port);
  
  const opts = url.parse("https://192.168.0.10/");
  opts.agent = new SocksProxyAgent(proxyUrl.href);
  
  https.get(opts, function (resp) {
    // 处理正常响应
  }).on("error", function (err) {
    if (!isProxyAlive) {
      console.log('故障类型：代理连接失败');
    } else {
      console.log('故障类型：代理正常，目标URL无法访问');
    }
    console.log(err);
  });
}

runRequest();

方案2：报错后回溯校验代理状态 #

如果不想每次请求都增加前置检测的耗时，可以在收到错误后再临时发起一次代理连通性校验，根据校验结果判断故障类型，适合请求量较低的场景：

// 错误回调中的逻辑
.on("error", async function (err) {
  const proxyUrl = new URL("socks4://works.local:1080");
  const isProxyAlive = await checkProxyAlive(proxyUrl.hostname, proxyUrl.port);
  if (!isProxyAlive) {
    console.log('故障类型：代理连接失败');
  } else {
    console.log('故障类型：代理正常，目标URL无法访问');
  }
});

注意事项 #

• 如果代理需要身份认证，简单的端口连通检测不足以确认代理可用性，可以在检测逻辑中补充Socks握手校验即可
• 若使用socks-proxy-agent v7及以上版本，可直接监听agent实例的error事件获取代理连接阶段的专属错误，也可实现故障区分

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