Undici：Node.js革命性HTTP/1.1客户端，性能超越传统方案289%
项目地址: https://gitcode.com/gh_mirrors/un/undici 你还在为Node.js应用中的HTTP请求性能问题发愁吗？当系统面临高并发请求时，传统HTTP客户端常常成为瓶颈，响应延迟、资源占用过高的问题接踵而至。今天，我们将介绍一款专为Node.js从零打造的HTTP/1.1客户端——Undici，它凭借创新的架构设计，在性能上实现了对传统方案289%的超越，彻底改变Node.js网络请求性能格局。读完本文，你将了解Undici的核心优势、性能提升原理以及如何快速上手使用这款高性能工具。
性能王者：Undici的基准测试成绩单
Undici的性能优势并非空穴来风，而是经过严格的基准测试验证。在基于Node 22.11.0环境，使用50个TCP连接、流水线深度为10的测试场景下，Undici展现出了惊人的性能表现。
从测试数据来看，传统方案如axios的请求处理能力为5708.26 req/sec，而Undici的dispatch模式达到了22234.42 req/sec，性能提升幅度高达289.51%。这意味着在相同的服务器资源下，使用Undici可以处理近三倍于传统方案的请求量，极大地提升了系统的吞吐量。
Undici的各个API模式在性能上也有不同表现，从高到低依次为：undici - dispatch（22234.42 req/sec）、undici - request（18340.17 req/sec）、undici - stream（18245.36 req/sec）、undici - pipeline（13364.62 req/sec）、undici - fetch（5903.78 req/sec）。开发者可以根据实际需求选择最适合的API模式，在性能和开发便捷性之间找到平衡。
核心优势：揭秘Undici高性能的四大法宝
1. 从零构建的精简架构
Undici是专为Node.js从零开始编写的HTTP客户端，没有历史代码包袱。它摒弃了传统客户端中复杂冗余的设计，采用更精简、更高效的代码路径，减少了不必要的资源消耗和性能损耗。这种从零构建的方式让Undici能够充分利用Node.js的特性，实现更优的性能。
2. 高效的连接池管理
Undici拥有先进的连接池管理机制，能够智能地管理TCP连接。通过合理地复用连接，减少了连接建立和关闭的开销，提高了连接的利用率。连接池的优化使得Undici在处理大量并发请求时能够保持高效稳定的性能。相关的实现代码可以在lib/pool/目录中找到，你可以深入研究其连接池的设计与实现。
3. HTTP/1.1流水线技术
Undici支持HTTP/1.1流水线技术，允许在单个TCP连接上发送多个HTTP请求，而无需等待每个请求的响应。这种技术大大减少了网络延迟，提高了请求的吞吐量。通过合理地设置流水线深度，可以在不增加网络连接数的情况下，显著提升系统的并发处理能力。
4. 优化的事件循环利用
Undici在设计上充分考虑了Node.js的事件循环机制，通过优化异步操作的处理方式，减少了事件循环的阻塞时间。这使得Undici能够更高效地处理并发请求，提高了系统的响应速度和整体性能。
快速上手：Undici的安装与基本使用
安装Undici
安装Undici非常简单，只需在项目中运行以下npm命令：
npm i undici
使用fetch API发送请求
Undici提供了符合标准的fetch API，让开发者能够快速上手。以下是一个使用fetch API发送请求的简单示例，代码来自docs/examples/fetch.js：
'use strict'
const { fetch } = require('../../')
async function main () {
const res = await fetch('http://localhost:3001/')
const data = await res.text()
console.log('response received', res.status)
console.log('headers', res.headers)
console.log('data', data)
}
main()
在这个示例中，我们首先导入Undici的fetch函数，然后使用它发送一个GET请求到http://localhost:3001/。获取响应后，我们通过res.text()方法获取响应体的文本内容，并打印出响应状态码、响应头和响应数据。
使用request API追求极致性能
如果你追求更高的性能，可以使用Undici的request API。以下是一个基本的使用示例：
import { request } from 'undici'
const { statusCode, headers, body } = await request('http://localhost:3000/foo')
console.log('response received', statusCode)
console.log('headers', headers)
console.log('data', await body.json())
request API提供了更底层的控制，能够更好地发挥Undici的性能优势。通过request方法发送请求后，我们可以获取响应的状态码、响应头和响应体等信息。
高级特性：释放Undici的全部潜能
缓存拦截器：提升请求效率
Undici提供了强大的缓存拦截器功能，能够根据HTTP缓存规则缓存请求响应，减少重复请求，提高请求效率。以下是使用缓存拦截器的示例代码：
import { fetch, Agent, interceptors, cacheStores } from 'undici';
// 创建带有缓存拦截器的客户端
const client = new Agent().compose(interceptors.cache({
store: new cacheStores.MemoryCacheStore({
maxSize: 100 * 1024 * 1024, // 100MB
maxCount: 1000,
maxEntrySize: 5 * 1024 * 1024 // 5MB
}),
methods: ['GET', 'HEAD']
}));
// 设置全局调度器使用缓存客户端
setGlobalDispatcher(client);
// 使用缓存发送请求
async function getData() {
const response = await fetch('https://api.example.com/data');
return response.json();
}
// 第一次请求 - 从源服务器获取
const data1 = await getData();
// 第二次请求 - 如果在缓存有效期内，从缓存获取
const data2 = await getData();
缓存拦截器支持Cache-Control和Expires头信息，能够自动进行缓存管理。同时，它还支持ETag和Last-Modified验证，确保缓存的有效性。你可以根据需求选择不同的缓存存储方式，如内存存储或持久化的SQLite存储，并配置缓存大小、TTL等参数。
连接池配置：优化连接管理
Undici允许你对连接池进行详细配置，以适应不同的应用场景。例如，你可以设置连接池的大小、超时时间等参数：
import { Agent } from 'undici';
const agent = new Agent({
keepAliveTimeout: 10000, // 连接保持超时时间
keepAliveMaxTimeout: 30000, // 连接最大保持超时时间
maxConnections: 100, // 最大连接数
pipelining: 10 // 流水线深度
});
setGlobalDispatcher(agent);
通过合理配置连接池参数，你可以进一步优化Undici的性能，使其更好地满足应用的需求。
版本兼容性与长期支持
Undici与Node.js的版本保持良好的兼容性，并遵循Node.js的LTS（长期支持）计划。以下是Undici版本与Node.js版本的对应关系以及支持情况：
| Undici Version | Bundled in Node.js | Node.js Versions Supported | End of Life |
|---|---|---|---|
| 5.x | 18.x | ≥14.0 (tested: 14, 16, 18) | 2024-04-30 |
| 6.x | 20.x, 22.x | ≥18.17 (tested: 18, 20, 21, 22) | 2026-04-30 |
| 7.x | 24.x | ≥20.18.1 (tested: 20, 22, 24) | 2027-04-30 |
你可以通过以下代码检查当前Node.js版本中捆绑的Undici版本：
console.log(process.versions.undici);
如果需要使用最新的Undici特性，你可以通过npm安装独立的Undici模块，而不受Node.js捆绑版本的限制。
总结与展望
Undici作为一款专为Node.js打造的HTTP/1.1客户端，凭借其从零构建的精简架构、高效的连接池管理、HTTP/1.1流水线技术以及优化的事件循环利用，实现了对传统方案289%的性能超越。它不仅提供了符合标准的fetch API，方便开发者快速上手，还提供了更底层的request API和丰富的高级特性，如缓存拦截器、连接池配置等，能够满足不同应用场景的需求。
随着Node.js生态的不断发展，Undici有望在未来发挥更加重要的作用。我们期待Undici能够持续优化性能，增加更多实用功能，为Node.js开发者带来更好的网络请求体验。
如果你正在开发Node.js应用，并且对HTTP请求性能有较高要求，不妨尝试一下Undici，相信它会给你带来惊喜。欢迎点赞、收藏本文，关注我们获取更多关于Undici的使用技巧和最佳实践。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
