在 graphql java 中，自定义异常映射为 graphqlformattederror 的核心是实现 datafetcherexceptionhandler 接口并注册到 graphql 构建器：创建处理器类重写 handleexception 方法，按异常类型构造 graphqlerror 并封装进 datafetcherexceptionhandlerresult；构建 graphql 实例时通过 .datafetcherexceptionhandler(...) 注入；推荐业务异常继承 runtimeexception，并可选扩展 graphqlformattederror 或配合 objectmapper 定制序列化。
在 Java 的 GraphQL 实现（如 GraphQL Java）中，自定义异常要映射为 GraphQLFormattedError，核心是通过配置 GraphQLErrorHandler 或使用 DataFetcherExceptionHandler 拦截异常并转换为标准错误格式。
实现自定义 DataFetcherExceptionHandler
这是最常用且推荐的方式，用于统一处理数据获取阶段抛出的异常：
- 创建一个类实现
DataFetcherExceptionHandler接口，重写handleException方法 - 在该方法中判断异常类型，构造
GraphQLError（如SimpleGraphQLError或自定义GraphQLFormattedError子类） - 将错误添加到
DataFetcherExceptionHandlerResult中返回
示例：
public class CustomExceptionHandler implements DataFetcherExceptionHandler {
@Override
public DataFetcherExceptionHandlerResult handleException(DataFetcherExceptionHandlerParameters handlerParameters) {
Throwable exception = handlerParameters.getException();
SourceLocation location = handlerParameters.getExecutionStepInfo().getSourceLocation();
if (exception instanceof BusinessException) {
String message = exception.getMessage();
Map<string object> extensions = new LinkedHashMap();
extensions.put("code", "BUSINESS_ERROR");
extensions.put("timestamp", System.currentTimeMillis());
GraphQLError error = GraphqlErrorBuilder.newError()
.message(message)
.location(location)
.extensions(extensions)
.build();
return DataFetcherExceptionHandlerResult.newResult()
.error(error)
.build();
}
// 兜底：委托给默认处理器
return DataFetcherExceptionHandlerResult.newResult()
.error(GraphqlErrorBuilder.newError().message("Internal error").build())
.build();
}
}</string>
注册异常处理器到 GraphQL 构建器
确保你的异常处理器被 GraphQL 执行引擎实际使用：
- 构建
GraphQL实例时，通过GraphQLRuntimeWiring或直接在GraphQL.newGraphQL(...)中传入 - 调用
.dataFetcherExceptionHandler(...)方法注入你实现的处理器
示例：
GraphQL graphQL = GraphQL.newGraphQL(schema)
.dataFetcherExceptionHandler(new CustomExceptionHandler())
.build();
让业务异常继承 RuntimeException（可选但推荐）
GraphQL Java 默认只捕获运行时异常；检查型异常需显式抛出或包装：
- 自定义异常建议继承
RuntimeException，避免在 resolver 中强制 try-catch - 若必须用检查型异常，可在 data fetcher 中手动包装为运行时异常再抛出
扩展 GraphQLFormattedError（按需）
如果需要更精细控制 JSON 序列化结构（如固定字段名、添加 traceId），可继承 GraphQLFormattedError：
- 重写
toSpecification()方法，返回符合 GraphQL 错误规范的 Map - 注意：GraphQL Java 5.0+ 中
GraphQLFormattedError是接口，推荐用GraphqlErrorBuilder构造，而非直接实现它 - 真正需要定制序列化行为时，可配合
ObjectMapper注册自定义序列化器
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
