Asp.Net Core+Structuremap中DbContext多实例引发LINQ查询异常排查

问题核心 #

你猜的没错！这个The specified LINQ expression contains references to queries that are associated with different contexts错误，根源就是同一个HTTP请求生命周期内创建了多个DbContext实例。当你的LINQ查询同时用到来自不同上下文的数据集（比如跨仓储关联查询），EF Core就会直接抛出这个异常——因为它没法把不同上下文的查询合并到一起执行。

先看仓储代码的潜在坑 #

假设你的仓储是类似下面这种常见的依赖注入写法：

public class UserRepository : IUserRepository
{
    private readonly AppDbContext _dbContext;

    public UserRepository(AppDbContext dbContext)
    {
        _dbContext = dbContext;
    }

    public IQueryable<User> GetActiveUsers()
    {
        return _dbContext.Users.Where(u => u.IsActive);
    }
}

public class OrderRepository : IOrderRepository
{
    private readonly AppDbContext _dbContext;

    public OrderRepository(AppDbContext dbContext)
    {
        _dbContext = dbContext;
    }

    public IQueryable<Order> GetOrdersForUser(int userId)
    {
        return _dbContext.Orders.Where(o => o.UserId == userId);
    }
}

如果同一个请求里，UserRepository和OrderRepository拿到的是不同的AppDbContext实例，那当你写from u in userRepo.GetActiveUsers() join o in orderRepo.GetOrdersForUser(u.Id) on u.Id equals o.UserId select ...这种跨仓储的查询时，必然会触发那个错误。

你的注册方式可能哪里错了？ #

StructureMap在ASP.NET Core里的生命周期配置是关键，我猜你可能踩了这几个坑：

• 把DbContext注册成了Singleton：虽然不会有跨上下文问题，但会引发并发冲突和内存泄漏，绝对不能这么干
• 用了Transient生命周期：每次请求依赖都会新建实例，同一个请求里不同仓储自然会拿到不同的上下文
• 没正确适配ASP.NET Core的Scoped请求生命周期：这才是DbContext该用的正确生命周期——同一个请求内所有依赖共享同一个实例

正确的StructureMap注册姿势 #

在你的StructureMap注册表中，必须把DbContext注册为Scoped（对应ASP.NET Core的请求生命周期），示例如下：

public class AppRegistry : Registry
{
    public AppRegistry(IConfiguration configuration)
    {
        // 核心：把DbContext注册为Scoped，确保同一个请求内复用同一个实例
        For<AppDbContext>().Use(() => 
            new AppDbContext(configuration.GetConnectionString("DefaultConnection")))
            .Scoped();

        // 仓储默认会继承DbContext的Scoped生命周期，无需额外配置
        For<IUserRepository>().Use<UserRepository>();
        For<IOrderRepository>().Use<OrderRepository>();
    }
}

如果你的仓储很多，也可以用自动扫描简化配置：

public class AppRegistry : Registry
{
    public AppRegistry(IConfiguration configuration)
    {
        Scan(scanner =>
        {
            scanner.AssemblyContainingType<AppDbContext>(); // 扫描当前程序集
            scanner.WithDefaultConventions(); // 自动匹配接口和实现类
            scanner.AddAllTypesOf<IRepository>().AsImplementedInterfaces().Scoped(); // 所有仓储用Scoped
        });

        // 依然要确保DbContext是Scoped
        For<AppDbContext>().Use(ctx => 
            new AppDbContext(configuration.GetConnectionString("DefaultConnection")))
            .Scoped();
    }
}

额外要排查的点 #

1. 别手动new DbContext！：如果代码里有直接new AppDbContext()的地方，哪怕只有一处，都会创建独立的实例，触发错误
2. 检查StructureMap的ASP.NET Core集成：确保你在Program.cs里正确启用了StructureMap：

var builder = WebApplication.CreateBuilder(args);
builder.Host.UseStructureMap(); // 这行不能少！

3. 中间件/过滤器里的DbContext使用：如果在中间件里需要用DbContext，必须通过IServiceScopeFactory创建作用域，不能直接从根容器拿——根容器拿的是Singleton或者Transient实例，会和请求内的上下文冲突

怎么验证是否解决了？ #

给你的DbContext加个实例ID，然后在构造函数里打日志，看看同一个请求内是不是只有一个实例：

public class AppDbContext : DbContext
{
    public Guid InstanceId { get; } = Guid.NewGuid();

    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options)
    {
        Console.WriteLine($"DbContext实例创建：{InstanceId}");
    }
}

发起一个请求，观察日志，如果同一个请求里出现多个不同的InstanceId，说明生命周期配置还是有问题；如果只有一个，那问题就解决了。

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