Ktorfit 2.2.0 修复 ExperimentalUuidApi 注解传递问题

在 Kotlin 多平台开发中，Ktorfit 作为一款强大的 HTTP 客户端框架，其 2.1.0 版本存在一个关于实验性 UUID API 注解传递的重要问题。这个问题会影响开发者使用 Kotlin 2.0.20 引入的新 UUID API。

问题背景

当开发者在接口中使用 Kotlin 的实验性 UUID 类型（kotlin.uuid.Uuid）作为参数时，需要添加 @OptIn(ExperimentalUuidApi::class) 注解。然而在 Ktorfit 2.1.0 版本中，这个注解不会自动传播到生成的实现类中，导致编译失败。

问题表现

开发者定义的接口如下：

@OptIn(ExperimentalUuidApi::class)
interface StoresApi {
    @GET("v1/stores")
    suspend fun getStores(@Query("workspaceId") workspaceId: Uuid)
}

编译时会收到错误提示，指出生成的实现类缺少必要的 ExperimentalUuidApi 注解。

技术影响

这个问题本质上是一个注解传播机制的缺陷。Ktorfit 在生成实现类时，没有正确处理源接口上的 opt-in 注解，导致：

1. 类型安全检查失败
2. 实验性 API 使用警告
3. 编译过程被中断

解决方案

Ktorfit 团队在 2.2.0 版本中修复了这个问题。新版本会正确传播以下内容：

1. 接口级别的 @OptIn 注解
2. 方法参数中的 Uuid 类型使用
3. 返回值中的实验性类型

升级建议

对于遇到此问题的开发者，建议：

1. 升级到 Ktorfit 2.2.0 或更高版本
2. 确保项目中使用的是 Kotlin 2.0.20+
3. 检查所有使用实验性 API 的接口是否正确定义

总结

这个修复体现了 Ktorfit 框架对 Kotlin 新特性的良好支持，确保了开发者能够无缝使用 Kotlin 标准库中的最新功能。对于使用实验性 API 的项目，及时升级到修复版本可以避免不必要的编译问题。