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
相关产品推荐
相关产品推荐

