Spring GraphQL 默认将 GraphQL 输入列表（如 [String!]!）反序列化为 List<T> 而非 Java 数组，若 resolver 或 input 类中仍使用 String[]，会导致空指针异常；正确做法是统一采用 List<String> 并确保构造器、字段和 getter 类型一致。
spring graphql 默认将 graphql 输入列表（如 `[string!]!`）反序列化为 `list
在基于 Spring GraphQL 的服务开发中，一个常见却容易被忽视的陷阱是：GraphQL 输入类型中的非空数组（如 [String!]!）在 Java 层不会自动绑定为 String[]，而是被 Jackson 与 GraphQL Java 协同解析为 List<String>。这并非 Bug，而是由 GraphQL 规范与 Spring 生态的数据映射约定共同决定的——GraphQL 本身不区分“数组”与“列表”，其输入对象（input）语义上始终是结构化字典，而列表字段在运行时由底层框架统一转为 java.util.List。
✅ 正确实现方式（以 MyArray 输入对象为例）
首先，修正 Java 输入类，全部使用 List<String>，包括构造器参数、私有字段及 getter：
public class MyArray {
private final List<String> arr;
// 构造器必须接收 List，不可用 String[]
public MyArray(List<String> arr) {
this.arr = arr != null ? new ArrayList<>(arr) : Collections.emptyList();
}
public List<String> getArr() {
return new ArrayList<>(arr); // 返回不可变副本更安全
}
}对应 Schema 必须严格匹配：
input MyArr {
arr: [String!]! # 非空列表，每个元素非空
}
type Query {
testQuery(args: MyArr!): String!
}Resolver 保持简洁，Spring 会自动完成 MyArr 实例注入：
@Controller
public class RecipesGraphQLController {
@QueryMapping
public String testQuery(@Argument MyArray args) {
// 安全访问：校验非空 + 防止 IndexOutOfBoundsException
if (args.getArr() == null || args.getArr().isEmpty()) {
throw new IllegalArgumentException("arr must contain at least one string");
}
return args.getArr().get(0);
}
}⚠️ 常见错误与避坑提示
❌ 错误：混合类型声明
如字段为 String[]，但构造器或 getter 用 List<String> —— Spring 绑定器无法识别类型不一致，最终注入 null。❌ 错误：忽略 @InputArgument 注解（旧版 Spring GraphQL）
在 Spring GraphQL 1.1+ 中，@Argument 已足够；但若使用早期版本，请确认是否需 @InputArgument 显式标注。-
✅ 推荐：启用严格模式验证
在 application.yml 中添加：spring: graphql: execution: errors: include-stacktrace: never # 生产环境禁用堆栈 graphiql: enabled: true并配合 @Valid + @NotNull 做 Bean 校验（需引入 spring-boot-starter-validation）：
public class MyArray { @NotNull private final List<@NotBlank String> arr; // ... }
? 调试建议：验证数据流是否完整
若仍遇 null，可在 Resolver 入口加断点并检查：
- 请求 JSON 是否含 "args":{"arr":["test"]}（GraphiQL 控制台 Network 标签页）；
- @Argument 参数是否为 null（说明解析失败）；
- 使用 @SchemaMapping 替代 @QueryMapping 可细粒度控制解析逻辑（进阶场景）。
总结：GraphQL 输入列表 → Java List<T> 是 Spring GraphQL 的标准行为。坚持「Schema 定义即契约，Java 类型即实现」原则，统一使用 List、避免数组、显式处理空值，即可彻底规避此类 NullPointerException。
