用途:为 .NET 应用提供 Entity Framework Core 的战术级实践模式,适用于 EF Core 8+,兼容 SQL Server、PostgreSQL、SQLite。
主要能力:DbContext 生命周期与作用域注册;AsNoTracking 及 AsNoTrackingWithIdentityResolution 只读查询优化;查询拆分(AsSplitQuery)避免多集合 Include 的笛卡尔积;迁移工作流与生产用迁移包;SaveChanges 与连接拦截器(审计时间戳、软删除、动态连接字符串);编译查询;连接弹性重试。
使用方式:Web 请求用 AddDbContext<T>() 注册为 scoped;后台服务与 Blazor Server 用 AddDbContextFactory<T>() 按需创建短生命周期上下文;高吞吐且无 scoped 注入时可用 AddDbContextPool<T>()。只读查询加 AsNoTracking(),多集合 Include 加 AsSplitQuery()。迁移命令如 dotnet ef migrations add、dotnet ef migrations script --idempotent、dotnet ef migrations bundle --self-contained,生产用 ./efbundle --connection "..."。连接弹性用 EnableRetryOnFailure。
适用场景:ASP.NET Core Web API/MVC、后台服务、Blazor Server、控制台应用的数据访问层。
限制:不涉及战略数据架构、数据访问技术选型、DI 容器机制、集成测试夹具与 DDD 领域建模;单结果编译查询委托不接受 CancellationToken;生产环境不应在启动时调用 Database.Migrate();池化上下文不可存储每请求状态或注入 scoped 服务。