使用graphqlcodegen生成Netflix DGS客户端时如何正确反序列化JSON响应？

方案1：调整GraphQL Codegen插件的命名策略配置 #

在Maven插件的<configuration>节点中添加命名规则配置，让生成的类和字段名与GraphQL返回的JSON字段大小写、名称完全匹配：

<plugin>
    <!-- 现有groupId、artifactId、version等配置不变 -->
    <configuration>
        <!-- 保留原有的packageName、schemaPaths等配置 -->
        <namingConventions>
            <!-- 字段名严格保留Schema中的原大小写，避免自动转换驼峰/下划线 -->
            <fieldNames>CASE_SENSITIVE</fieldNames>
            <!-- 类名也保持与Schema定义一致 -->
            <typeNames>CASE_SENSITIVE</typeNames>
        </namingConventions>
        <!-- 其他原有配置 -->
    </configuration>
</plugin>

该配置会让生成的响应类字段名和类名严格对应Schema中的定义，和返回的JSON结构完全匹配。

方案2：配置反序列化工具的字段匹配规则 #

如果无法调整插件生成规则，可以通过修改Jackson的反序列化配置，让它忽略字段名大小写或者适配命名差异：

// 自定义ObjectMapper，开启大小写不敏感匹配
ObjectMapper objectMapper = new ObjectMapper();
objectMapper.configure(MapperFeature.ACCEPT_CASE_INSENSITIVE_PROPERTIES, true);

// 将自定义ObjectMapper注入到GraphQL客户端中（根据你使用的客户端类型调整）
// 例如如果是DGS客户端，可以通过DgsClientBuilder配置
DgsClient dgsClient = DgsClientBuilder.newInstance()
        .url("your-graphql-endpoint")
        .objectMapper(objectMapper)
        .build();

这样反序列化时会自动匹配不同大小写的字段名，避免因大小写差异导致失败。

方案3：让插件自动生成序列化注解 #

配置插件自动给生成的字段添加Jackson的@JsonProperty注解，指定对应的JSON字段名：

<plugin>
    <!-- 现有配置不变 -->
    <configuration>
        <!-- 保留原有配置 -->
        <generateJsonMapperAnnotations>true</generateJsonMapperAnnotations>
        <!-- 指定Jackson注解的包路径 -->
        <jsonMapperAnnotationPackage>com.fasterxml.jackson.annotation</jsonMapperAnnotationPackage>
    </configuration>
</plugin>

生成的字段会自动带上@JsonProperty("Pharma_assessEligibility")这类注解，明确指定JSON字段名，确保反序列化时的匹配。

内容的提问来源于stack exchange，提问作者Thiago Sayão