Node.js中Axios经代理调用HTTPS API遇“HTTP请求发至HTTPS端口”错误求助

排查步骤 #

• 核对代理协议与端口匹配：检查Axios代理配置的protocol字段，若目标是HTTPS接口，代理地址必须用https://协议，不能用http://，否则会把HTTP请求发往HTTPS端口触发错误。比如代理端口是443（HTTPS默认端口），却把protocol设为http就是典型错误。
• 直接测试代理可用性：用curl命令验证代理能否处理HTTPS请求，比如执行curl -x https://proxy.example.com:443 https://target-api.com，如果同样报错，说明代理服务器本身不支持HTTPS转发，或端口配置错误。
• 检查Agent配置：若手动指定了httpsAgent，确认是否开启了代理支持，或是否存在证书验证问题导致请求挂起。
• 排查全局代理冲突：检查系统环境变量HTTP_PROXY、HTTPS_PROXY是否与Axios配置冲突，比如HTTPS_PROXY被设为HTTP协议地址，会覆盖代码中的代理配置。

解决方案 #

修正代理协议配置 #

确保代理的协议、端口与服务器实际配置匹配，示例代码：

const axios = require('axios');
const https = require('https');

const axiosInstance = axios.create({
  proxy: {
    protocol: 'https',
    host: 'proxy.example.com',
    port: 443,
    auth: { // 若代理需要认证，添加用户名密码
      username: 'your-proxy-user',
      password: 'your-proxy-pass'
    }
  },
  httpsAgent: new https.Agent({
    rejectUnauthorized: false // 若代理用自签名证书，临时关闭验证（生产环境建议配置可信CA）
  })
});

// 测试HTTPS请求
axiosInstance.get('https://target-api.com/api')
  .then(res => console.log(res.data))
  .catch(err => console.error(err.message));

动态区分HTTP/HTTPS代理 #

如果代理服务器对HTTP和HTTPS请求使用不同端口/协议，可根据请求地址动态创建Axios实例：

const axios = require('axios');
const https = require('https');
const http = require('http');

const getAxiosInstance = (targetUrl) => {
  const isHttps = targetUrl.startsWith('https');
  const proxy = {
    host: 'proxy.example.com',
    port: isHttps ? 443 : 8080,
    protocol: isHttps ? 'https' : 'http'
  };
  const agent = isHttps 
    ? new https.Agent({ rejectUnauthorized: false }) 
    : new http.Agent();

  return axios.create({
    proxy,
    [isHttps ? 'httpsAgent' : 'httpAgent']: agent
  });
};

// 使用示例
getAxiosInstance('https://target-api.com/api')
  .get('https://target-api.com/api')
  .then(console.log)
  .catch(console.error);

清理环境变量冲突 #

若环境变量中的代理配置错误，可在启动脚本中临时设置正确的变量：

HTTPS_PROXY=https://proxy.example.com:443 node your-app.js

或在代码中手动覆盖环境变量：

process.env.HTTPS_PROXY = 'https://proxy.example.com:443';

配置代理证书验证 #

如果代理服务器要求客户端证书验证，需在httpsAgent中配置证书文件：

const fs = require('fs');
const httpsAgent = new https.Agent({
  cert: fs.readFileSync('./client-cert.pem'),
  key: fs.readFileSync('./client-key.pem'),
  ca: fs.readFileSync('./ca-cert.pem') // 代理CA证书
});

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