Scala调用GraphQL接口的最佳代码生成器推荐

OpenAPI Generator的局限性 #

OpenAPI Generator本质是为REST API（基于OpenAPI/Swagger规范）设计的工具，对GraphQL的支持几乎可以忽略——官方没有专门的GraphQL Scala客户端生成模块，强行用它处理GraphQL schema只会得到混乱、不可用的代码，别浪费时间在这上面。

推荐的GraphQL Scala代码生成器 #

1. Sangria Codegen #

这是Scala生态里最贴合GraphQL场景的代码生成工具，和Scala主流的GraphQL服务端库Sangria深度绑定。

• 能从GraphQL schema生成完全类型安全的Scala客户端代码，包括查询、突变的类型定义，以及请求封装逻辑。
• 支持生成同步或异步客户端，适配Akka HTTP、Play Framework等常用Scala HTTP框架。
• 使用简单：通过sbt插件配置schema文件路径和代码输出目录，运行sbt sangriaCodegenGenerate就能自动生成代码。

2. Apollo Kotlin（原Apollo Android） #

虽然起源于Android，但完全兼容JVM/Scala环境，是功能最完善的GraphQL客户端生成工具之一。

• 支持从你的GraphQL查询文件生成类型安全的客户端代码，自动处理请求序列化和响应解析。
• 内置缓存、批量请求、自动重试等实用特性，适合复杂业务场景。
• 集成方式：添加sbt依赖，配置schema和查询文件路径，编译阶段自动完成代码生成。

3. GraphQL Code Generator #

这是一个跨语言的通用GraphQL代码生成工具，通过Scala插件可以生成符合需求的客户端代码。

• 灵活性极高，能自定义生成逻辑，适配各种Scala HTTP客户端（如JDK HttpClient、Play WS）。
• 支持从schema或已写好的查询文件生成类型安全的操作类和数据模型。
• 使用步骤：安装CLI工具，编写codegen.yml配置输出语言为Scala，执行graphql-codegen命令即可生成代码。

选型参考 #

• 如果你的项目已经用Sangria做GraphQL服务端，优先选Sangria Codegen，生态兼容性拉满。
• 要是需要丰富的客户端特性（缓存、多平台支持），Apollo Kotlin是不二之选。
• 若项目需要跨语言生成，或者要高度自定义代码结构，GraphQL Code Generator更合适。

内容的提问来源于stack exchange，提问作者baum