Quarkus类型安全GraphQL客户端：添加参数实现过滤查询

问题分析 #

你遇到的GraphQlClientException是因为SmallRye静态客户端默认将Java的String类型参数映射为GraphQL的String类型，但服务端的查询参数预期是ID类型（尽管GraphQL中ID常以字符串形式传递，但类型定义上是独立的）。

解决方案 #

在接口方法的参数上添加@GraphQLArgument注解，显式指定参数对应的GraphQL类型为ID即可解决。

修改后的接口代码示例 #

import org.eclipse.microprofile.graphql.GraphQLArgument;
import java.util.List;

public interface StarWarsClientApi {
    // 原有查询所有影片的方法
    List<Film> allFilms();

    // 修正后的单影片查询方法
    Film film(@GraphQLArgument(name = "filmID", typeName = "ID") String filmID);
}

原理说明 #

SmallRye静态客户端会严格根据接口定义生成GraphQL查询语句，通过@GraphQLArgument的typeName属性，可以强制将Java的String参数映射为GraphQL的ID类型，生成的查询变量会被声明为$filmID: ID，与服务端的类型要求匹配。

动态客户端之所以能正常工作，是因为它不需要严格的类型绑定，会自动处理类型兼容场景，但静态客户端需要明确的类型映射声明。

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