【免费下载链接】wreqAn ergonomic, privacy-aware Rust HTTP Client项目地址https://gitcode.com/gh_mirrors/rq/wreq点击查看免费下载wreq 是一款面向 Rust 的异步 HTTP 客户端定位是 down to the wire——不仅实现 HTTP/1、HTTP/2 协议栈还通过http3feature 将 HTTP/3 做到 QUIC 连接的 wire 层。它继承了 Hyper 客户端侧的多年打磨同时把执行器executor、定时器timer、传输层transport全部抽象为可插拔接口让你在自己的运行时里精细控制每一个字节。一图看懂wreq 在协议栈中的位置普通 HTTP 库往往止步于发请求、收响应而 wreq 深入到底层字节流能力协议依据实现位置HTTP/1.1 解析与编码RFC 9112src/proto/http1/HTTP/2 连接、流、ping、升级RFC 9113src/proto/http2/HTTP/3 Extended CONNECTRFC 9114 / RFC 8441src/proto/http3/HTTP Datagram 会话RFC 9297src/conn/http3/datagram.rs运行时无关的 QUIC 传输契约RFC 9000src/rt/quic.rs简单说wreq 负责HTTP 消息 ↔ 协议帧 ↔ 字节这三层转换而 QUIC socket 的创建和 TLS 握手留给调用方这是它 privacy-aware 设计的一部分——库不替你做网络决策。快速上手三个 feature 开关控制协议栈在 Cargo.toml 中可以看到 wreq 的 feature 设计非常克制full [tracing, http3, http3-datagram] http3 [dep:http3, dep:http-body-util] http3-datagram [http3, dep:http3-datagram] tracing [dep:tracing, http2/tracing, tracing?/std, http3?/tracing]默认 feature 为空开箱只有 HTTP/1 和 HTTP/2编译依赖最少。打开http3获得基于外部 QUIC 连接的 HTTP/3 客户端。打开http3-datagram在 HTTP/3 连接上启用 RFC 9297 的 HTTP Datagram 会话。打开tracing接入结构化日志三个协议全部支持。 这种按需付费的 feature 门控意味着你在嵌入式或最小化部署里不会为用不到的协议付编译成本。统一的客户端模型SendRequest Connectionwreq 的 API 按协议组织但三者的心智模型完全一致源码入口在 src/conn.rsuse netty::conn::{http1, http2};HTTP/1一条连接顺序执行src/conn/http1.rs 提供两个核心类型SendRequestB连接建立后的发送端通过try_send_request发出请求。发送队列是有界的配合want背压机制见 src/dispatch.rs天然防止请求无限堆积。ConnectionT, B负责驱动整条连接 IO 状态机通常spawn到执行器中持续运行。一个贴心的细节Connection::into_parts()能把 HTTP/1 连接拆解回收原始 IO 对象和已读入但尚未处理的字节缓冲read_buf——这正是 WebSocket 等协议升级后继续通信所需要的。HTTP/2流复用 优雅取消src/conn/http2.rs 中的SendRequestB支持 CloneHTTP/2 一条连接可并发多路复用请求并暴露poll_ready/is_ready等就绪探测。HTTP/2 特有的能力包括Extended CONNECTRFC 8441通过扩展 CONNECT 在隧道中协商 WebSocket 等协议PING 保活实现在 src/proto/http2/ping.rs连接级配置Http2Options可调max_local_error_reset_streams、reset_stream_duration等见 RELEASE.md 的 0.2.5 更新日志。HTTP/3外部 QUIC 连接 请求准入控制src/conn/http3.rs 的模型是调用方建好 QUIC/TLS 连接再交给 wreqlet (mut tx, connection) Builder::new(exec).handshake::_, FullBytes(quic).await?; let connection tokio::spawn(connection);请求不排队、不 spawn每个请求都跑在try_send_request返回的 future 里drop 该 future 就等于取消该请求语义清晰。准入控制Http3Options::max_concurrent_requests默认 128限制本地并发请求数防止 QUIC 流信用被耗尽。精细的 QPACK 调优max_field_section_size、qpack_encoder_table_capacity、qpack_blocked_streams等字段全部暴露在 src/proto/http3.rs 的Http3Options中。流式 Body 与背压不缓冲整个响应wreq 对请求体和响应体一律使用流式 body核心逻辑在 src/body/Incomingsrc/body/incoming.rs接收端 body 的具体类型基于 channel 实现按帧frame推进只在被 poll 时才推进处理完当前帧再请求下一帧天然形成对连接的反压back-pressure支持 trailersHTTP/1 的 chunked 尾部头、HTTP/2/3 的 TRAILERS 帧都能收到。use http_body_util::BodyExt as _; use netty::body::Incoming; async fn read_body(mut body: Incoming) - Result(), netty::Error { while let Some(frame) body.frame().await { // 逐帧消费 data / trailers保持背压 } Ok(()) }⚠️ 官方建议只有在确定响应小而可信时才用collect()整体收进内存对不可信的大 body配合Limited之类的限流包装。取消语义三个协议三种断法这是 wreq 文档src/lib.rs中最值得细读的设计——同一个drop future动作在三个协议下的 wire 行为完全不同协议drop 请求 future 的效果连接能否复用HTTP/1无协议内取消手段驱动会关闭底层 IO❌ 连接作废HTTP/2发送RST_STREAMCANCEL 错误码✅ 其他流不受影响HTTP/3以H3_REQUEST_CANCELLED取消收发方向✅ 连接继续可用这种cancel safety文档化的程度对做生产级客户端的同学非常重要取消一个请求绝不会悄悄拖死整条连接HTTP/1 是协议限制wreq 如实告知你后果。可插拔运行时Executor、Timer、QUIC 三件套wreq 的rt模块src/rt.rs是它运行时无关的关键rt::Executor一个极简 trait——fn execute(self, fut)任何能跑 future 的运行时都能适配rt::Timer/Time/Sleep抽象定时能力HTTP/2 的 ping、超时逻辑都不绑定具体运行时rt::quic::Connectionsrc/rt/quic.rsHTTP/3 的 QUIC 传输契约只提供独立流打开器和流 ID不创建 UDP socket、不做 TLS、不选运行时rt::quic::Compatsrc/rt/quic/compat.rs适配器把基于 http3 自家quictrait 写的传输如http3-quic直接接进来。约束边界在 src/rt/bounds.rs 中用 trait 别名收口Http2ClientConnExec、Http3ClientConnExec等实现了通用Executor就会自动获得这些能力无需手写样板代码。 仓库里的tokio/compio适配代码只存在于 tests/support/ 测试工具中——这正说明产品代码本身对运行时零依赖。Upgrade 与 CONNECT 隧道除了标准请求wreq 把先说 HTTP、再切换协议的路径做成了统一 API见 src/upgrade.rsHTTP/1.1 Upgrade如 WebSocket 握手101后拿到Upgraded对象可继续读写裸 IOHTTP/1/2 CONNECT 隧道支持代理与 h2 CONNECT 测试HTTP/3 Extended CONNECT Datagram通过请求 extension 指定协议如Protocol::WEBSOCKETDatagram 会话在 src/conn/http3/datagram.rs。let request http::Request::connect(https://example.com/tunnel) .extension(Protocol::WEBSOCKET) .body(())?;细节打磨ext 扩展与错误设计ext把协议边角料变成一等公民src/ext.rs 提供三类消息级扩展都是 wire 层库才关心的细节ReasonPhrase保留 HTTP/1 响应中非标准的 reason phrase标准库通常会丢弃on_informational回调 1xx 信息性响应不含 101on_preserve_header自定义请求头处理包括 HTTP/1 的头字段大小写与顺序——这在某些老服务器上真的会影响行为。error可读、可查、不承诺字面量src/error.rs 的Error提供is_shutdown()、is_incomplete_message()、source()链式查询Kind覆盖了从Parse、Io到Http2、Http3的全部分类。文档明确声明错误文案不得依赖只依赖结构化查询——这是成熟库的契约精神。质量基线测试与基准如何支撑down to the wire协议集成测试tests/client.rs、tests/integration.rsHTTP/3 另有独立套件 tests/http3/body、credit、pause、soak 长时间浸泡测试等真实服务端对打dev-dependencies 里用 hyper 1.x 起 HTTP/1/2 服务端、用h3/quinn起 QUIC 环境交叉验证兼容性性能基准bench/body.rs 测 body 吞吐、bench/end_to_end.rs 测端到端、bench/http3.rs 专门压 HTTP/3。什么时候选 wreq✅适合需要同时兼容 HTTP/1、2、3 且想自己掌控 QUIC 与 TLS 栈的项目对取消语义、背压、连接生命周期有严格 SLA 要求的客户端网关、SDK、嵌入式网关想复用 Hyper 久经考验的协议逻辑但需要比高层客户端更细的底层接口。❌不适合只想三行代码发个 GET 的场景——wreq 是连接级API连接池、域名解析、重定向需要你在外层组合这正是它的分层哲学。目录导览按需跳读源码入口与协议说明src/lib.rs连接 APIsrc/conn.rs 下的 http1 / http2 / http3协议状态机src/proto/h1 的 buf/decode/encode/io/role 值得逐文件精读流式 bodysrc/body.rs运行时契约src/rt.rs、src/rt/bounds.rs、src/rt/quic.rs请求分发与背压src/dispatch.rs版本演进全记录RELEASE.mdwreq 用把协议做到 wire 层 把运行时交给调用方这一组合给出了 Rust 异步 HTTP 客户端的一种务实答案协议逻辑经过验证边界控制交给你。如果你正在构建对协议细节敏感的 HTTP 客户端这套源码值得放进你的精读清单。赞分享【免费下载链接】wreqAn ergonomic, privacy-aware Rust HTTP Client项目地址https://gitcode.com/gh_mirrors/rq/wreq点击查看免费下载相关推荐hyper 1.x 深入指南用 Rust 构建异步 HTTP/1 与 HTTP/2 客户端和服务端hyper 1.x 深入指南用 Rust 构建异步 HTTP/1 与 HTTP/2 客户端和服务端 hyper 是一个用 Rust 编写、面向 HTTP/1后端网络HTTP/2客户端支持async-http-client完整指南 HTTP/2客户端支持async http client完整指南 在现代Java应用开发中 async http client 作为一个强大的异步HT后端网络HTTP/2客户端示例async-http-client异步网络编程完全指南HTTP/2客户端示例async http client异步网络编程完全指南 在现代Java应用开发中 异步HTTP客户端 已经成为处理高并发网络请求的必备后端网络创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/15 16:35:20 · 阅读 1.2k wreq完整指南:这款Rust异步HTTP客户端如何把HTTP/1、HTTP/2、HTTP/3做到wire层
【免费下载链接】wreqAn ergonomic, privacy-aware Rust HTTP Client项目地址https://gitcode.com/gh_mirrors/rq/wreq点击查看免费下载wreq 是一款面向 Rust 的异步 HTTP 客户端定位是 down to the wire——不仅实现 HTTP/1、HTTP/2 协议栈还通过http3feature 将 HTTP/3 做到 QUIC 连接的 wire 层。它继承了 Hyper 客户端侧的多年打磨同时把执行器executor、定时器timer、传输层transport全部抽象为可插拔接口让你在自己的运行时里精细控制每一个字节。一图看懂wreq 在协议栈中的位置普通 HTTP 库往往止步于发请求、收响应而 wreq 深入到底层字节流能力协议依据实现位置HTTP/1.1 解析与编码RFC 9112src/proto/http1/HTTP/2 连接、流、ping、升级RFC 9113src/proto/http2/HTTP/3 Extended CONNECTRFC 9114 / RFC 8441src/proto/http3/HTTP Datagram 会话RFC 9297src/conn/http3/datagram.rs运行时无关的 QUIC 传输契约RFC 9000src/rt/quic.rs简单说wreq 负责HTTP 消息 ↔ 协议帧 ↔ 字节这三层转换而 QUIC socket 的创建和 TLS 握手留给调用方这是它 privacy-aware 设计的一部分——库不替你做网络决策。快速上手三个 feature 开关控制协议栈在 Cargo.toml 中可以看到 wreq 的 feature 设计非常克制full [tracing, http3, http3-datagram] http3 [dep:http3, dep:http-body-util] http3-datagram [http3, dep:http3-datagram] tracing [dep:tracing, http2/tracing, tracing?/std, http3?/tracing]默认 feature 为空开箱只有 HTTP/1 和 HTTP/2编译依赖最少。打开http3获得基于外部 QUIC 连接的 HTTP/3 客户端。打开http3-datagram在 HTTP/3 连接上启用 RFC 9297 的 HTTP Datagram 会话。打开tracing接入结构化日志三个协议全部支持。 这种按需付费的 feature 门控意味着你在嵌入式或最小化部署里不会为用不到的协议付编译成本。统一的客户端模型SendRequest Connectionwreq 的 API 按协议组织但三者的心智模型完全一致源码入口在 src/conn.rsuse netty::conn::{http1, http2};HTTP/1一条连接顺序执行src/conn/http1.rs 提供两个核心类型SendRequestB连接建立后的发送端通过try_send_request发出请求。发送队列是有界的配合want背压机制见 src/dispatch.rs天然防止请求无限堆积。ConnectionT, B负责驱动整条连接 IO 状态机通常spawn到执行器中持续运行。一个贴心的细节Connection::into_parts()能把 HTTP/1 连接拆解回收原始 IO 对象和已读入但尚未处理的字节缓冲read_buf——这正是 WebSocket 等协议升级后继续通信所需要的。HTTP/2流复用 优雅取消src/conn/http2.rs 中的SendRequestB支持 CloneHTTP/2 一条连接可并发多路复用请求并暴露poll_ready/is_ready等就绪探测。HTTP/2 特有的能力包括Extended CONNECTRFC 8441通过扩展 CONNECT 在隧道中协商 WebSocket 等协议PING 保活实现在 src/proto/http2/ping.rs连接级配置Http2Options可调max_local_error_reset_streams、reset_stream_duration等见 RELEASE.md 的 0.2.5 更新日志。HTTP/3外部 QUIC 连接 请求准入控制src/conn/http3.rs 的模型是调用方建好 QUIC/TLS 连接再交给 wreqlet (mut tx, connection) Builder::new(exec).handshake::_, FullBytes(quic).await?; let connection tokio::spawn(connection);请求不排队、不 spawn每个请求都跑在try_send_request返回的 future 里drop 该 future 就等于取消该请求语义清晰。准入控制Http3Options::max_concurrent_requests默认 128限制本地并发请求数防止 QUIC 流信用被耗尽。精细的 QPACK 调优max_field_section_size、qpack_encoder_table_capacity、qpack_blocked_streams等字段全部暴露在 src/proto/http3.rs 的Http3Options中。流式 Body 与背压不缓冲整个响应wreq 对请求体和响应体一律使用流式 body核心逻辑在 src/body/Incomingsrc/body/incoming.rs接收端 body 的具体类型基于 channel 实现按帧frame推进只在被 poll 时才推进处理完当前帧再请求下一帧天然形成对连接的反压back-pressure支持 trailersHTTP/1 的 chunked 尾部头、HTTP/2/3 的 TRAILERS 帧都能收到。use http_body_util::BodyExt as _; use netty::body::Incoming; async fn read_body(mut body: Incoming) - Result(), netty::Error { while let Some(frame) body.frame().await { // 逐帧消费 data / trailers保持背压 } Ok(()) }⚠️ 官方建议只有在确定响应小而可信时才用collect()整体收进内存对不可信的大 body配合Limited之类的限流包装。取消语义三个协议三种断法这是 wreq 文档src/lib.rs中最值得细读的设计——同一个drop future动作在三个协议下的 wire 行为完全不同协议drop 请求 future 的效果连接能否复用HTTP/1无协议内取消手段驱动会关闭底层 IO❌ 连接作废HTTP/2发送RST_STREAMCANCEL 错误码✅ 其他流不受影响HTTP/3以H3_REQUEST_CANCELLED取消收发方向✅ 连接继续可用这种cancel safety文档化的程度对做生产级客户端的同学非常重要取消一个请求绝不会悄悄拖死整条连接HTTP/1 是协议限制wreq 如实告知你后果。可插拔运行时Executor、Timer、QUIC 三件套wreq 的rt模块src/rt.rs是它运行时无关的关键rt::Executor一个极简 trait——fn execute(self, fut)任何能跑 future 的运行时都能适配rt::Timer/Time/Sleep抽象定时能力HTTP/2 的 ping、超时逻辑都不绑定具体运行时rt::quic::Connectionsrc/rt/quic.rsHTTP/3 的 QUIC 传输契约只提供独立流打开器和流 ID不创建 UDP socket、不做 TLS、不选运行时rt::quic::Compatsrc/rt/quic/compat.rs适配器把基于 http3 自家quictrait 写的传输如http3-quic直接接进来。约束边界在 src/rt/bounds.rs 中用 trait 别名收口Http2ClientConnExec、Http3ClientConnExec等实现了通用Executor就会自动获得这些能力无需手写样板代码。 仓库里的tokio/compio适配代码只存在于 tests/support/ 测试工具中——这正说明产品代码本身对运行时零依赖。Upgrade 与 CONNECT 隧道除了标准请求wreq 把先说 HTTP、再切换协议的路径做成了统一 API见 src/upgrade.rsHTTP/1.1 Upgrade如 WebSocket 握手101后拿到Upgraded对象可继续读写裸 IOHTTP/1/2 CONNECT 隧道支持代理与 h2 CONNECT 测试HTTP/3 Extended CONNECT Datagram通过请求 extension 指定协议如Protocol::WEBSOCKETDatagram 会话在 src/conn/http3/datagram.rs。let request http::Request::connect(https://example.com/tunnel) .extension(Protocol::WEBSOCKET) .body(())?;细节打磨ext 扩展与错误设计ext把协议边角料变成一等公民src/ext.rs 提供三类消息级扩展都是 wire 层库才关心的细节ReasonPhrase保留 HTTP/1 响应中非标准的 reason phrase标准库通常会丢弃on_informational回调 1xx 信息性响应不含 101on_preserve_header自定义请求头处理包括 HTTP/1 的头字段大小写与顺序——这在某些老服务器上真的会影响行为。error可读、可查、不承诺字面量src/error.rs 的Error提供is_shutdown()、is_incomplete_message()、source()链式查询Kind覆盖了从Parse、Io到Http2、Http3的全部分类。文档明确声明错误文案不得依赖只依赖结构化查询——这是成熟库的契约精神。质量基线测试与基准如何支撑down to the wire协议集成测试tests/client.rs、tests/integration.rsHTTP/3 另有独立套件 tests/http3/body、credit、pause、soak 长时间浸泡测试等真实服务端对打dev-dependencies 里用 hyper 1.x 起 HTTP/1/2 服务端、用h3/quinn起 QUIC 环境交叉验证兼容性性能基准bench/body.rs 测 body 吞吐、bench/end_to_end.rs 测端到端、bench/http3.rs 专门压 HTTP/3。什么时候选 wreq✅适合需要同时兼容 HTTP/1、2、3 且想自己掌控 QUIC 与 TLS 栈的项目对取消语义、背压、连接生命周期有严格 SLA 要求的客户端网关、SDK、嵌入式网关想复用 Hyper 久经考验的协议逻辑但需要比高层客户端更细的底层接口。❌不适合只想三行代码发个 GET 的场景——wreq 是连接级API连接池、域名解析、重定向需要你在外层组合这正是它的分层哲学。目录导览按需跳读源码入口与协议说明src/lib.rs连接 APIsrc/conn.rs 下的 http1 / http2 / http3协议状态机src/proto/h1 的 buf/decode/encode/io/role 值得逐文件精读流式 bodysrc/body.rs运行时契约src/rt.rs、src/rt/bounds.rs、src/rt/quic.rs请求分发与背压src/dispatch.rs版本演进全记录RELEASE.mdwreq 用把协议做到 wire 层 把运行时交给调用方这一组合给出了 Rust 异步 HTTP 客户端的一种务实答案协议逻辑经过验证边界控制交给你。如果你正在构建对协议细节敏感的 HTTP 客户端这套源码值得放进你的精读清单。赞分享【免费下载链接】wreqAn ergonomic, privacy-aware Rust HTTP Client项目地址https://gitcode.com/gh_mirrors/rq/wreq点击查看免费下载相关推荐hyper 1.x 深入指南用 Rust 构建异步 HTTP/1 与 HTTP/2 客户端和服务端hyper 1.x 深入指南用 Rust 构建异步 HTTP/1 与 HTTP/2 客户端和服务端 hyper 是一个用 Rust 编写、面向 HTTP/1后端网络HTTP/2客户端支持async-http-client完整指南 HTTP/2客户端支持async http client完整指南 在现代Java应用开发中 async http client 作为一个强大的异步HT后端网络HTTP/2客户端示例async-http-client异步网络编程完全指南HTTP/2客户端示例async http client异步网络编程完全指南 在现代Java应用开发中 异步HTTP客户端 已经成为处理高并发网络请求的必备后端网络创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考