Spring GraphQL默认将GraphQL输入中的数组（如[String!]!）反序列化为List而非Java原生数组，若Resolver或Input类仍使用String[]会导致空引用异常；正确做法是统一使用List并确保构造器、getter与字段类型一致。
spring graphql默认将graphql输入中的数组（如[string!]!）反序列化为list而非java原生数组，若resolver或input类仍使用string[]会导致空引用异常；正确做法是统一使用list
在基于 Spring GraphQL（v1.1.2 + Spring Boot 3.0.5 + Java 17）构建的服务中，开发者常误以为 GraphQL 的输入列表（如 [String!]!）会自动映射为 Java 原生数组（String[]）。但实际行为截然不同：Spring GraphQL 底层依赖 graphql-java 的数据绑定机制，而该机制严格遵循 GraphQL 规范中“输入对象字段值必须可序列化为 Java Bean 或标准集合”，其默认将非标量输入列表映射为 java.util.List，而非数组类型。
这意味着，即使你的 GraphQL Schema 明确声明：
input MyArr {
arr: [String!]!
}
type Query {
testQuery(args: MyArr!): String!
}
且客户端发送合法请求：
{
testQuery(args: { arr: ["test"] })
}
Spring 在执行参数解析时，会尝试将 JSON 中的 ["test"] 绑定到 Java 类型。若你定义的 MyArray 类中字段为 private String[] arr，而构造器和 getter 也基于 String[]，则框架无法完成类型匹配——因为传入的实际运行时对象是 ArrayList 实例，不是 String[]，最终导致字段未被赋值，arr 保持 null，进而触发 NullPointerException。
✅ 正确实现方式如下：
1. 更新 Input 类，统一使用 List
public class MyArray {
private final List<string> arr;
// 必须提供 List 类型的构造器（Spring 通过反射调用）
public MyArray(List<string> arr) {
this.arr = arr;
}
// getter 也返回 List<string>
public List<string> getArr() {
return arr;
}
}</string></string></string></string>
⚠️ 注意：
- 构造器参数类型、字段类型、getter 返回类型三者必须完全一致（均为 List
）； - 不要添加无参构造器或 @AllArgsConstructor（Lombok），除非明确配置了 @Builder 或 @Data 的兼容策略——Spring GraphQL 默认依赖带参构造器进行不可变对象绑定。
2. Resolver 方法保持类型一致：
@Controller
public class RecipesGraphQLController {
@QueryMapping
public String testQuery(@Argument MyArray args) {
// 安全访问，arr 不再为 null
if (args.getArr() == null || args.getArr().isEmpty()) {
throw new IllegalArgumentException("arr cannot be empty");
}
return args.getArr().get(0); // ✅ 安全获取首个元素
}
}
3. （可选）若需直接接收顶层数组（非嵌套在 input object 中）：
type Query {
testQuery(args: [String!]!): String!
}
对应 Resolver 应改为：
@QueryMapping
public String testQuery(@Argument List<string> args) {
return args.get(0);
}</string>
❌ 错误示范（引发 NPE）：
// ❌ 即使加了 @NonNull 注解也无法阻止绑定失败
@QueryMapping
public String testQuery(@Argument String[] args) { ... } // Spring 无法将 List 转为 String[]
? 调试建议：
- 在 Resolver 入口加断点，用 IDE 查看 args 实际运行时类型（通常是 LinkedHashMap 或 ArrayList）；
- 启用 Spring GraphQL 日志：logging.level.org.springframework.graphql=DEBUG，观察 InputObjectValue 到 Java 对象的转换过程；
- 避免混合使用 Lombok 的 @Data 与自定义构造器——它可能生成冲突的 setter，干扰不可变绑定。
总结：GraphQL 输入列表 → Spring GraphQL → List
