如何在GraphQL Schema中映射大小写不同的Java枚举？

你有如下Java枚举：

public enum JavaStatus{
ACTIVE,
PAUSED,
STOPPPED;
}

希望通过GraphQL收发该枚举时使用小写值，同时前端能通过GraphQL Schema查看可选值，因此定义的schema.graphqls包含：

enum GraphqlStatus{
active
paused
stopped
}

你尝试了以下代码做映射：

@Bean(name = "graphqlStatusEnum")
public GraphQLEnumType graphqlStatusEnum() {
    return GraphQLEnumType.newEnum().name("GraphqlStatus")
            .value("active", JavaStatus.ACTIVE)
            .value("paused", JavaStatus.PAUSED)
            .value("stopped", JavaStatus.STOPPPED)
            .build();
}

但出现错误：

枚举'JavaStatus'中找不到名为'active'的值！

问题原因 #

手动构建GraphQLEnumType但未配置对应的类型转换逻辑，GraphQL默认会把收到的小写字符串直接匹配Java枚举的大写名称，导致无法找到对应值报错。

正确映射方案 #

方案1：自定义枚举类型+转换器（通用Spring GraphQL场景） #

步骤1：修复并注册自定义GraphQLEnumType

先修正Bean的语法错误，再将自定义枚举类型注册到GraphQL的运行时配置中：

@Bean
public GraphQLEnumType graphqlStatusEnum() {
    return GraphQLEnumType.newEnum()
            .name("GraphqlStatus")
            .value("active", JavaStatus.ACTIVE)
            .value("paused", JavaStatus.PAUSED)
            .value("stopped", JavaStatus.STOPPPED)
            .build();
}

@Bean
public RuntimeWiringConfigurer runtimeWiringConfigurer(GraphQLEnumType graphqlStatusEnum) {
    return wiringBuilder -> wiringBuilder
            .type(TypeRuntimeWiring.newTypeWiring("GraphqlStatus")
                    .enumValues(graphqlStatusEnum));
}

步骤2：添加枚举转换处理器

创建转换器类，处理GraphQL字符串与Java枚举的双向转换：

@Component
public class JavaStatusConverter implements Converter<String, JavaStatus>, Converter<JavaStatus, String> {

    @Override
    public JavaStatus convert(String source) {
        return switch (source) {
            case "active" -> JavaStatus.ACTIVE;
            case "paused" -> JavaStatus.PAUSED;
            case "stopped" -> JavaStatus.STOPPPED;
            default -> throw new IllegalArgumentException("无效的状态值: " + source);
        };
    }

    @Override
    public String convert(JavaStatus source) {
        return switch (source) {
            case ACTIVE -> "active";
            case PAUSED -> "paused";
            case STOPPPED -> "stopped";
        };
    }
}

方案2：使用注解简化配置（Spring GraphQL/DGS框架） #

直接在Java枚举上添加@GraphQLEnumValue注解，指定对应的GraphQL小写值，无需手动构建枚举类型：

public enum JavaStatus{
    @GraphQLEnumValue(name = "active")
    ACTIVE,
    @GraphQLEnumValue(name = "paused")
    PAUSED,
    @GraphQLEnumValue(name = "stopped")
    STOPPPED;
}

保持schema.graphqls中的GraphqlStatus枚举定义，框架会自动完成双向映射。

验证效果 #

配置完成后：

• 前端发送小写枚举值（如active）时，后端会自动转换为JavaStatus.ACTIVE
• 后端返回JavaStatus枚举时，会自动转为小写字符串返回给前端
• 前端可通过GraphQL Schema查看GraphqlStatus的所有可选小写值

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