Spring Boot GraphQL如何抑制异常并返回HTTP.NO_CONTENT_FOUND状态码

完全可以通过GraphQL原生异常处理机制、或者业务层预处理实现需求，以下是3种不同场景的落地方式：

1. 全局DataFetcher异常拦截（官方推荐，无业务侵入） #

GraphQL 原生提供DataFetcherExceptionHandler接口，专门处理数据拉取阶段抛出的ExceptionWhileDataFetching类异常，就是你日志中看到的报错类型：

• 第一步：自定义异常处理器，匹配目标异常特征

public class NotFoundDataFetcherExceptionHandler implements DataFetcherExceptionHandler {
    private final DataFetcherExceptionHandler defaultHandler = SimpleDataFetcherExceptionHandler.defaultImpl();

    @Override
    public DataFetcherExceptionHandlerResult onException(DataFetcherExceptionHandlerParameters params) {
        Throwable ex = params.getException();
        // 匹配你的报错特征：消息包含结果数量不匹配的描述
        if (ex.getMessage() != null && ex.getMessage().contains("Incorrect result size: expected 1, actual 0")) {
            // 方式1：直接返回空结果，不往响应的errors字段加报错
            return DataFetcherExceptionHandlerResult.newResult().build();
            // 方式2：抛出标记类的自定义异常，后续用来映射404状态码
            // throw new ResourceNotFoundException();
        }
        // 其余异常走默认处理逻辑
        return defaultHandler.onException(params);
    }
}

• 第二步：注册自定义处理器到GraphQL实例

GraphQL graphQL = GraphQL.newGraphQL(schema)
    .defaultDataFetcherExceptionHandler(new NotFoundDataFetcherExceptionHandler())
    .build();

• 第三步：映射HTTP 404状态码
  如果用Spring GraphQL，可实现WebGraphQlInterceptor，拿到响应后如果判断返回数据为空、或者携带自定义的ResourceNotFoundException，直接修改响应状态为HttpStatus.NOT_FOUND即可。

2. 业务层提前判空（小场景快速实现） #

你遇到的报错本质是JPA等持久层框架的getSingleResult()方法在查询无结果时抛出的异常，也可以直接在业务层修正：

• 把getSingleResult()调用替换为先调用getResultList()，判断结果长度为0时直接返回null，不会抛出异常
• 对应Schema中把该查询字段设为可空类型，返回null时不会触发GraphQL数据拉取异常，上层直接判断字段为null时返回404即可。

3. 响应后置拦截（兼容老项目改造） #

如果无法修改GraphQL核心配置，可以在HTTP入口层加过滤器/拦截器，拦截GraphQL接口的响应内容，解析body中的errors字段，匹配到目标异常后删除errors字段，同时修改HTTP状态码为404。

注意点 #

• GraphQL原生支持单次请求查询多个资源，如果是批量查询场景，不建议单个字段为空就返回404，优先返回空数据+业务错误码更符合规范
• 异常匹配时建议同时校验异常类型，不要仅靠消息内容匹配，避免误拦截其他异常

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