使用graphql-dotnet时DataLoader上下文为空的原因排查

这是GraphQL.NET使用DataLoader时非常常见的问题，我帮你梳理几个最可能的原因和解决办法：

1. 服务未正确注册 #

首先要确认你已经在依赖注入容器中正确注册了DataLoader相关服务。在ASP.NET Core的Program.cs或Startup.cs中，你需要添加：

// 这会自动注册IDataLoaderContextAccessor和相关中间件
builder.Services.AddDataLoader();

如果是手动注册的话，要确保：

builder.Services.AddSingleton<IDataLoaderContextAccessor, DataLoaderContextAccessor>();
builder.Services.AddScoped<DataLoaderMiddleware>();

如果没注册这些服务，注入的IDataLoaderContextAccessor本身可能是null，或者它的Context属性永远不会被初始化。

2. 在请求上下文之外访问DataLoaderContext #

这是最常见的原因：你在Graph类型的构造函数里直接尝试获取DataLoader。

Graph类型的构造函数是在应用启动时（或第一次使用时）执行的，而不是每个请求执行。这时候还没有任何GraphQL请求在处理，IDataLoaderContextAccessor.Context自然是空的。

错误示例： #

public class UserGraphType : ObjectGraphType<User>
{
    public UserGraphType(IDataLoaderContextAccessor accessor)
    {
        // 这里会报错！构造函数执行时没有请求上下文
        var loader = accessor.Context.GetOrAddBatchLoader<int, Post>("userPosts", FetchUserPosts);
        
        Field<ListGraphType<PostGraphType>>("posts")
            .Resolve(ctx => loader.LoadAsync(ctx.Source.Id));
    }
}

正确示例： #

把DataLoader的获取逻辑移到字段的解析器（Resolve方法）里，解析器是在每个请求处理时执行的，这时候上下文已经存在：

public class UserGraphType : ObjectGraphType<User>
{
    public UserGraphType(IDataLoaderContextAccessor accessor)
    {
        Field<ListGraphType<PostGraphType>>("posts")
            .Resolve(ctx => 
            {
                // 这里安全，因为解析器在请求上下文内执行
                var loader = accessor.Context.GetOrAddBatchLoader<int, Post>("userPosts", FetchUserPosts);
                return loader.LoadAsync(ctx.Source.Id);
            });
    }
}

3. 请求管道配置错误 #

如果你的ASP.NET请求管道中，GraphQL中间件的位置不对，或者DataLoader中间件没有被正确添加，也会导致上下文无法初始化。

确保UseGraphQL中间件在管道中的位置正确，并且AddDataLoader()已经添加了必要的中间件。如果你手动配置管道，要确保DataLoaderMiddleware在GraphQL中间件之前执行：

app.UseMiddleware<DataLoaderMiddleware>();
app.UseGraphQL<MySchema>();

4. 异步操作丢失上下文 #

如果在异步代码中使用了ConfigureAwait(false)，可能会丢失HttpContext（而DataLoaderContext是绑定到HttpContext的），导致accessor.Context变为null。在字段解析器的异步流程中，尽量避免不必要的ConfigureAwait(false)，确保上下文被正确保留。

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