Tapir v1.11.22 版本发布：全面迁移至 STTP Client4 的重大升级

项目简介

Tapir 是一个功能强大的 Scala 类型安全 HTTP API 定义库，它允许开发者以类型安全的方式定义 HTTP 端点，并自动生成文档、客户端和服务端代码。作为 Scala 生态系统中 API 开发的重要工具，Tapir 提供了对多种 HTTP 客户端和服务端实现的支持。

版本核心变更

本次发布的 v1.11.22 版本带来了多项重要改进，其中最引人注目的是从 STTP Client3 到 STTP Client4 的全面迁移。这一变更标志着 Tapir 在 HTTP 客户端支持方面迈入了新的阶段。

STTP Client4 迁移

STTP Client4 是 Scala 生态中广受欢迎的 HTTP 客户端库的最新主要版本。Tapir 团队完成了从 Client3 到 Client4 的平滑过渡，这一变更涉及：

1. 核心接口的适配和重构
2. 向后兼容性的保证
3. 性能优化和功能增强

迁移过程中，团队特别关注了 API 的稳定性，确保现有用户能够无缝升级。新版本中，所有与 STTP 相关的模块都已更新为使用 Client4 的接口和实现。

新增 STTP 存根服务器模块

作为本次发布的另一个亮点，团队引入了一个全新的模块，专门提供基于 STTP Client4 的存根服务器功能。这一特性为开发者带来了：

• 更轻量级的测试环境搭建方式
• 与 Client4 更好的集成体验
• 更灵活的 API 模拟能力

这个新模块特别适合在单元测试和集成测试场景中使用，开发者现在可以更便捷地创建模拟服务来测试客户端行为。

安全修复与改进

在安全方面，本次版本修复了基础认证安全类型声明的问题。这一修复确保了：

• 生成代码时基础认证相关类型声明的正确性
• 安全定义的完整性验证
• 与 OpenAPI 规范的更好兼容

依赖项升级

为了保持生态系统的健康和安全，Tapir v1.11.22 对多个关键依赖进行了版本升级：

1. Vert.x 升级至 4.5.14：带来了 Web 框架的性能改进和稳定性增强
2. Netty 升级至 4.2.0.Final：底层网络库的重大版本更新，包含多项性能优化
3. Swagger UI 升级至 5.20.3：API 文档界面的最新版本，提供更好的用户体验
4. OpenTelemetry 语义约定升级至 1.32.0：增强了可观测性支持
5. Enumeratum 升级至 1.7.6：改进了枚举类型的处理

开发者影响与升级建议

对于现有 Tapir 用户，升级到 v1.11.22 版本需要注意以下几点：

1. STTP 客户端兼容性：如果项目中直接使用了 STTP 客户端，需要确保相关代码与 Client4 兼容
2. 测试环境调整：可以考虑使用新的存根服务器模块来简化测试
3. 依赖冲突检查：特别是 Netty 和 Vert.x 等核心依赖，需确认与其他库的兼容性

对于新用户，这个版本提供了更现代化的 HTTP 客户端支持和更完善的测试工具链，是开始使用 Tapir 的良好时机。

未来展望

从本次更新可以看出，Tapir 团队正持续投入于：

• 与 Scala 生态系统最新技术的集成
• 开发者体验的不断优化
• 安全性和稳定性的持续改进

随着 STTP Client4 的全面采用，Tapir 在 HTTP 客户端支持方面达到了新的成熟度，为未来的功能扩展奠定了坚实基础。