ZIO HTTP 3.2.0 版本发布：性能优化与功能增强

ZIO HTTP 是一个基于 ZIO 生态系统的纯函数式 HTTP 服务端和客户端库，它提供了高性能、类型安全的 Web 开发体验。最新发布的 3.2.0 版本带来了一些重要的变更和功能增强，值得开发者关注。

重要变更：IO uring 默认禁用

在 3.2.0 版本中，ZIO HTTP 不再默认启用 IO uring 功能。IO uring 是 Linux 5.1 引入的高性能异步 I/O 接口，能够显著提升网络应用的性能。然而，由于它是一个实验性功能，且需要特定的环境支持，开发团队决定将其设为可选配置。

如果您的应用需要追求极致性能，可以查阅文档了解如何手动激活 IO uring 支持。这一变更体现了 ZIO HTTP 团队对稳定性和兼容性的重视，同时也为高级用户保留了性能优化的空间。

OpenAPI 认证支持

3.2.0 版本的一个重要改进是现在可以在 Endpoint 上设置认证信息，这些信息会自动生成到 OpenAPI 文档中。这意味着：

1. 开发者可以更方便地为 API 添加认证要求
2. 生成的 OpenAPI 文档会包含完整的认证信息
3. 前端开发者可以更准确地了解 API 的认证需求

这一特性使得 ZIO HTTP 在 API 文档化方面更加完善，特别适合需要严格认证机制的企业级应用。

新增 Curl 日志中间件

新版本引入了 Curl 日志中间件，这是一个实用的调试工具。它可以：

1. 将 HTTP 请求转换为等效的 curl 命令格式
2. 方便开发者重现和调试 API 调用
3. 在开发环境中快速验证请求的正确性

这个功能特别适合在开发和测试阶段使用，可以显著提升调试效率。

性能优化与功能增强

路由系统改进

• 为 Routes 添加了特定的 404 处理机制
• 简化了 Routes/RoutePattern 的树形结构
• 优化了路由匹配的性能

表单处理优化

• 改进了 Form#toQueryParams 方法的性能
• 修复了 QueryModifier.addQueryParam 方法中重复添加旧值的问题

请求/响应增强

• 为 Request 和 Response 添加了 addCookie 和 addCookies 方法
• Response 新增了 bodyAs 方法，方便直接获取响应体内容

安全功能

• 增加了服务器端 JKS 密钥库和信任库支持
• 改进了认证机制与 OpenAPI 的集成

依赖项更新

3.2.0 版本更新了多个依赖项，包括：

• zio-schema 升级到 1.6.6
• tapir-http4s-server 升级到 1.11.20
• protobuf-java 升级到 4.30.1
• zio-config 升级到 4.0.4

这些更新带来了更好的兼容性和新特性支持。

总结

ZIO HTTP 3.2.0 版本在保持稳定性的同时，带来了多项实用改进。从 OpenAPI 认证支持到性能优化，再到新的调试工具，这个版本为开发者提供了更强大的功能和更好的开发体验。特别是 IO uring 的默认禁用决策，体现了项目对生产环境稳定性的重视。

对于正在使用或考虑使用 ZIO HTTP 的开发者来说，3.2.0 版本值得升级。它不仅提供了更多便利的功能，还在性能和稳定性方面做出了改进，是构建高性能、类型安全 HTTP 服务的优秀选择。