Spring Boot 3.2 GraphQL测试抛异常时AssertionError问题排查

核心排查与修复方向 #

1. 自定义异常处理器适配问题 #

Spring Boot 3.2对GraphQL异常处理逻辑有更新，需确保你的自定义处理器适配最新规范：

• 必须实现GraphQLErrorHandler接口，而非已废弃的旧接口，确保将业务异常转换为标准GraphQLError实例，包含明确的message和必要的extensions字段，同时设置正确的错误分类（如GraphQLErrorCategory.BAD_REQUEST）。
• 示例正确的处理器结构：

@Component
public class CustomGraphQLErrorHandler implements GraphQLErrorHandler {
    @Override
    public List<GraphQLError> processErrors(List<GraphQLError> errors) {
        return errors.stream()
                .map(this::wrapBusinessError)
                .collect(Collectors.toList());
    }

    private GraphQLError wrapBusinessError(GraphQLError error) {
        if (error instanceof ExceptionWhileDataFetching fetchError) {
            if (fetchError.getException() instanceof BizException bizEx) {
                return new GenericGraphQLError(
                        bizEx.getMessage(),
                        fetchError.getLocations(),
                        fetchError.getPath(),
                        Map.of("errorCode", bizEx.getErrorCode())
                );
            }
        }
        return error;
    }
}

2. 测试断言逻辑修正 #

测试中使用graphQlTester.errors()断言时，不要直接匹配异常类，要针对GraphQL返回的错误内容做校验：

• 断言错误的message或自定义extensions字段，因为业务异常会被包装为ExceptionWhileDataFetching，无法直接匹配原始异常类型。
• 示例正确断言方式：

graphQlTester.document("""
        query {
            getResource(id: "invalid-123")
        }
        """)
        .execute()
        .errors()
        .satisfy(errors -> {
            assertThat(errors).hasSize(1);
            GraphQLError error = errors.get(0);
            assertThat(error.getMessage()).isEqualTo("资源ID格式非法");
            assertThat(error.getExtensions()).containsEntry("errorCode", "INVALID_RESOURCE_ID");
        });

3. 异常链路检查 #

确认Controller→Service→Client的链路中，异常未被意外捕获：

• 检查Service层的try-catch块，确保业务异常被直接抛出，而非被吞掉或转换为非GraphQL可识别的异常。
• Client调用外部服务时的异常，需转换为统一业务异常抛出，避免返回默认值或空结果。

4. 测试环境配置调整 #

在application-test.yml中开启GraphQL异常处理开关，确保错误信息正常返回：

spring:
  graphql:
    servlet:
      exception-handling:
        enabled: true
        include-stacktrace: never

快速验证步骤 #

1. 用GraphiQL手动触发异常场景，查看返回的JSON错误结构，确认消息和扩展字段是否符合预期。
2. 在测试中临时添加print()打印所有错误，对比断言内容是否匹配：

graphQlTester.document(...)
        .execute()
        .errors()
        .print()
        .satisfy(...);

3. 确认自定义异常处理器被Spring容器扫描到，已添加@Component或@Bean注解。

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