NextJS生产环境getServerSideProps中Axios请求TLS连接异常求助

以下是针对你遇到的Client network socket disconnected before secure TLS connection was established错误的具体排查步骤：

1. 强制指定Axios的TLS版本 #

部分服务器仅支持特定TLS版本（如TLS 1.2），而Axios默认使用的TLS版本可能与目标服务器不兼容。可以通过配置HTTPS Agent强制指定TLS版本：

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

const getImageUrl = async (parameter) => {
  const httpsAgent = new https.Agent({
    // 强制使用TLS 1.2，可根据目标服务器支持情况调整为tls1、tls1_1或tls1_3
    secureProtocol: 'TLSv1_2_method',
    // 注意：禁用证书验证仅用于测试，生产环境请勿开启
    // rejectUnauthorized: false
  });

  return axios.post('你的目标接口地址', parameter, { httpsAgent })
    .then(res => res.data.url)
    .catch(err => { throw err; });
};

2. 排除VPN网络干扰 #

• 在生产服务器上直接执行curl命令测试目标接口，验证网络连通性：

  curl -v -X POST -H "Content-Type: application/json" -d '你的请求参数' https://目标接口地址
  

  • 如果curl请求成功，说明问题出在Axios配置而非网络；
  • 如果curl也失败，大概率是VPN拦截了TLS握手请求，需要检查VPN的端口放行规则、是否存在TLS中间人拦截（需确保服务器信任VPN的根证书）。

3. 调整Axios超时与重试策略 #

网络不稳定可能导致TLS握手超时，可增加超时时间并添加重试机制：

const axios = require('axios');
const axiosRetry = require('axios-retry');

axiosRetry(axios, {
  retries: 3, // 重试次数
  retryDelay: (retryCount) => retryCount * 1000, // 每次重试间隔1秒
  retryCondition: (error) => {
    // 仅对ECONNRESET等网络错误重试
    return error.code === 'ECONNRESET' || error.code === 'ETIMEDOUT';
  }
});

const getImageUrl = async (parameter) => {
  return axios.post('你的目标接口地址', parameter, {
    timeout: 10000 // 超时时间设为10秒
  }).then(res => res.data.url);
};

4. 验证目标服务器的TLS支持情况 #

使用openssl命令检查目标服务器支持的TLS版本：

# 测试TLS 1.2
openssl s_client -connect 目标域名:443 -tls1_2
# 测试TLS 1.3
openssl s_client -connect 目标域名:443 -tls1_3

如果某一版本的命令能成功建立连接，就将Axios的secureProtocol配置为对应版本。

5. 检查Node.js版本兼容性 #

不同Node.js版本默认的TLS套件和版本存在差异：

• Node.js 14+默认启用TLS 1.3，若目标服务器不支持，会导致握手失败；
• 可尝试升级Node.js到稳定版，或在Node.js启动时添加参数强制指定TLS版本：

  node --tls-min-v1.2 server.js
  

内容的提问来源于stack exchange，提问作者Ariel K.