Blazor ASP.NET Core 7中GraphQL查询错误处理问题咨询

关于HotChocolate Error Filter的作用范围 #

HotChocolate的Error Filter不是仅面向开发者工具（如Banana Cake Pop），它的设计目标是统一处理GraphQL请求的错误，确保所有客户端（包括Blazor）都能拿到规范的GraphQL错误响应。你遇到的问题核心原因是ASP.NET Core的全局错误处理中间件（比如默认的ExceptionHandler）拦截了GraphQL的错误响应，将其替换成了通用的HTTP 500提示，而非HotChocolate生成的包含自定义错误的响应体。

让Blazor客户端获取自定义错误的修复方案 #

1. 调整ASP.NET Core全局错误处理范围

默认的全局异常处理会捕获所有请求的异常并返回通用错误，你需要让GraphQL端点绕过这个处理：

// 在Program.cs中，调整中间件顺序，排除GraphQL路径
app.UseWhen(context => !context.Request.Path.StartsWithSegments("/graphql"), appBuilder =>
{
    appBuilder.UseExceptionHandler("/Error");
});

或者直接给GraphQL端点禁用异常处理：

app.MapGraphQL()
   .WithMetadata(new DisableExceptionHandlerMetadata());

2. 配置HotChocolate错误暴露规则

确保HotChocolate允许将错误细节返回给客户端，同时注意生产环境的安全性（不要暴露敏感异常信息）：

builder.Services.AddGraphQLServer()
    .AddQueryType<YourQueryType>()
    .AddErrorFilter<YourCustomErrorFilter>() // 注册你的自定义错误过滤器
    .ModifyOptions(options => 
    {
        // 开发环境暴露完整异常，生产环境仅返回自定义错误信息
        options.ExposeExceptions = builder.Environment.IsDevelopment();
        options.IncludeExceptionDetails = builder.Environment.IsDevelopment();
    });

3. 确保自定义Error Filter正确实现

你的Error Filter需要正确捕获异常并转换为GraphQL错误，示例：

public class CustomErrorFilter : IErrorFilter
{
    public IError OnError(IError error)
    {
        if (error.Exception is AccessDeniedException ex)
        {
            return error.WithMessage($"Access is denied {ex.ErrorCode}.")
                        .WithCode("AUTH_ACCESS_DENIED");
        }
        return error;
    }
}

是否需要改用ObjectResult？不推荐 #

返回ObjectResult是打破GraphQL规范的做法。GraphQL的设计就是通过响应体中的errors数组返回错误，这样客户端可以在一次请求中处理多个字段的错误，同时保持响应格式统一。如果改用ObjectResult，你需要额外处理HTTP状态码、非标准响应格式，增加客户端的处理复杂度，也违背了GraphQL的设计初衷。

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