You need to enable JavaScript to run this app. Hot Chocolate GraphQL中审计查询的正确位置及IRequestContext获取问题
优惠活动
大模型
产品
解决方案
定价
更多

Hot Chocolate GraphQL中审计查询的正确位置及IRequestContext获取问题

Hot Chocolate v11 查询审计逻辑实现方案

选型结论

你的选型判断完全正确:

  • DiagnosticEventListener 属于非侵入式的事件监听组件,设计上不允许阻断主流程执行,完全无法满足审计失败拦截请求的需求,会出现你提到的操作逃逸问题。
  • HttpRequestInterceptor 是请求进入Hot Chocolate执行管道的第一个可扩展节点,支持在查询解析、执行前直接阻断请求,完全匹配你的业务要求。

具体实现步骤

你不需要手动从IRequestExecutor或QueryRequestBuilder中获取IRequestContext,IHttpRequestInterceptor的内置方法已经暴露了所有审计所需的上下文信息,实现方案如下:

1. 实现自定义审计拦截器

using Hot Chocolate.AspNetCore.CSharp;
using Hot Chocolate.Execution;
using System.Security.Claims;

public class AuditHttpRequestInterceptor : DefaultHttpRequestInterceptor
{
    // 注入你自己的审计日志服务
    private readonly IAuditLogWriter _auditLogWriter;

    public AuditHttpRequestInterceptor(IAuditLogWriter auditLogWriter)
    {
        _auditLogWriter = auditLogWriter;
    }

    public override async ValueTask OnCreateAsync(
        HttpContext httpContext,
        IRequestExecutor requestExecutor,
        IQueryRequestBuilder requestBuilder,
        CancellationToken cancellationToken)
    {
        // 1. 提取审计所需的所有字段
        // 从ASP.NET Core上下文提取身份、客户端信息
        var userId = httpContext.User.FindFirstValue(ClaimTypes.NameIdentifier);
        var clientIp = httpContext.Connection.RemoteIpAddress?.ToString();
        var traceId = httpContext.TraceIdentifier;

        // 从请求构造器提取GraphQL查询相关信息
        var queryRequest = requestBuilder.Create();
        var queryContent = queryRequest.Query?.ToString();
        var operationName = queryRequest.OperationName;
        var requestVariables = queryRequest.Variables?.ToDictionary(k => k.Key, v => v.Value);

        // 2. 执行审计写入逻辑
        bool auditSuccess = await _auditLogWriter.WriteAsync(new AuditLogEntry
        {
            UserId = userId,
            ClientIp = clientIp,
            TraceId = traceId,
            QueryContent = queryContent,
            OperationName = operationName,
            Variables = requestVariables,
            RequestTime = DateTime.UtcNow
        }, cancellationToken);

        // 3. 审计失败直接抛出异常,阻断后续所有操作
        if (!auditSuccess)
        {
            throw new InvalidOperationException("请求审计校验失败,已终止访问");
        }

        // 审计通过后继续执行原有管道逻辑
        await base.OnCreateAsync(httpContext, requestExecutor, requestBuilder, cancellationToken);
    }
}

2. 注册拦截器到Hot Chocolate管道

在服务注册代码中添加拦截器注册即可生效:

// .NET 6+ Program.cs 写法
builder.Services.AddGraphQLServer()
    // 注册自定义审计拦截器
    .AddHttpRequestInterceptor<AuditHttpRequestInterceptor>()
    // 你原有其他配置,例如.AddQueryType(), AddMutationType()等
    ;

补充说明

  • 如果确实有场景需要访问完整的IRequestContext,可以额外实现IQueryExecutionInterceptor,在其OnExecuteAsync方法中可以直接拿到IRequestContext实例,但审计逻辑放在HttpRequestInterceptor阶段已经是最早的拦截节点,完全可以避免操作逃逸问题。
  • 若需要兼顾审计可靠性和接口性能,可以先将审计日志写入本地高速队列异步落库,同时增加写入失败的告警机制,避免同步写入数据库拖慢接口响应。

内容的提问来源于stack exchange,提问作者Jason

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.22 03:36:03