You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

sttp tapir中含类型别名的case class无法隐式推导Schema问题

问题原因

你使用的tapir 0.18.0-M15版本的自动Schema推导逻辑存在类型别名识别局限性:泛型类型的别名在宏推导阶段不会被自动展开为原始泛型类型,推导器无法识别EitherAlias等价于Either[String, Int],自然找不到对应的Schema隐式实例。
注意:你自定义的circe Codec和tapir Schema推导是两套独立逻辑,circe的Codec推导支持类型别名不代表Schema推导也支持,二者没有依赖关系,不要混淆。

解决方案
  • 方案1:显式声明类型别名对应的Schema实例
    在定义类型别名的位置同步定义对应的隐式Schema:
type EitherAlias = Either[String, Int]
implicit val schemaForEitherAlias: Schema[EitherAlias] = Schema.schemaForEither[String, Int]
  • 方案2:开启类型别名自动展开配置
    在导入自动推导的基础上,增加推导配置强制展开类型别名:
import sttp.tapir.generic.Configuration
implicit val customDerivationConfig: Configuration = Configuration.default.withUseTypeAliasesForNames(false)
  • 方案3:手动为目标case class推导Schema
    直接手动推导case class的Schema,避开字段类型识别问题:
implicit val clsSchema: Schema[Cls] = Schema.derived[Cls]

内容的提问来源于stack exchange,提问作者André Machado

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.30 23:48:00