如何在Axios中终止keepAlive持久连接？实例GC回收是否自动断连

核心结论 #

axios本身不直接管理持久连接的生命周期，你配置的keepAlive: true能力来自Node.js原生的https.Agent连接池，所有连接的创建、复用、断开逻辑都由这个Agent实例负责，和axios实例本身无直接关联。

如何按需主动断开持久连接 #

axios没有提供内置的断开连接方法，你只需要拿到创建的https.Agent实例的引用，调用其原生的destroy()方法即可关闭该连接池下所有持久连接（包括空闲连接和正在传输的连接）。
不要像示例代码一样匿名创建Agent实例，要单独保存Agent的引用：

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

// 单独持有Agent实例引用，不要匿名写在axios配置里
const persistentAgent = new https.Agent({
  keepAlive: true,
  // 可选：配置空闲连接超时时间，避免连接长期闲置
  freeSocketTimeout: 30000, // 空闲30秒自动断开
});

const axiosInstance = axios.create({
  baseURL: 'https://httpbin.org/headers',
  headers: { 'X-Custom-Header': 'foobar' },
  httpsAgent: persistentAgent,
});

// 发起请求
axiosInstance
  .get()
  .then((response) => console.log(response.headers))
  .catch((err) => console.log(err.message));

// 业务处理完成需要断开时，直接调用即可
function closeAllPersistentConnections() {
  persistentAgent.destroy();
  // 后续如果需要恢复连接，重新创建Agent实例赋值给axiosInstance.defaults.httpsAgent即可
}

注意：axios用来取消单个请求的CancelToken/AbortSignal只能中断正在进行的请求，无法关闭已经回到连接池的空闲持久连接，不要用这个API来处理连接断开需求。

axios实例被GC回收时，持久连接会不会自动断开 #

不会可靠自动断开，绝对不要依赖GC机制来关闭连接，原因如下：

• 持久连接的所有权属于https.Agent实例，不属于axios实例。如果Agent实例还有其他地方持有引用，哪怕axios实例被回收，Agent和它管理的所有连接都会一直存在。
• 就算Agent实例随着axios实例一起失去所有引用，被GC回收的时机也是完全不可控的，在回收前空闲连接会一直占用TCP资源，甚至会出现半开连接（服务端已经超时断开，客户端还没感知）。
• GC回收JS对象时不会主动执行套接字的优雅断开逻辑，可能导致连接没有正常发送TCP FIN包，产生异常连接残留。

最佳实践 #

• 始终单独持有keepAlive Agent的引用，不要匿名创建
• 业务逻辑明确不需要持久连接时，主动调用agent.destroy()显式释放连接资源
• 可以给Agent配置freeSocketTimeout参数，让空闲超过指定时长的连接自动断开，避免长期闲置的连接占用资源

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