最省事的启动加速方式是用dotnet ef dbcontext optimize生成compiled model，但必须严格对齐构建环境、ef core运行时版本和provider类型，否则会因不兼容抛出invalidoperationexception；官方推荐在ci中先发布再优化，确保同源，并通过ismodelcached验证是否生效。
直接用 dotnet ef dbcontext optimize 生成 Compiled Model 是最省事的启动加速方式，但跳过验证和绑定检查，上线后大概率报 InvalidOperationException: The compiled model is not compatible with the current DbContext type。必须按构建环境、运行时版本、Provider 类型三重对齐，缺一不可。
怎么生成 Compiled Model 才不踩坑
EF Core 官方推荐的 CLI 方式（dotnet ef dbcontext optimize）看似一键，实则隐含三个硬性前提：
- 执行命令的 SDK 版本、
Microsoft.EntityFrameworkCore运行时包版本、Provider 包（如Microsoft.EntityFrameworkCore.SqlServer）版本，三者必须与最终发布环境完全一致； - DbContext 类不能有签名变更——包括泛型参数数量、基类继承链、构造函数参数列表，哪怕加一个
private readonly string _tag字段也会导致加载失败； - 实体配置必须全部静态（即不能在
OnModelCreating中调用远程 API、读取配置文件、或使用IMutableModel动态修改）。
建议在 CI 流水线中固定生成步骤：先 dotnet publish -c Release -r win-x64 --self-contained false，再在相同输出目录下执行 dotnet ef dbcontext optimize，确保模型二进制与部署包同源。
UseCompiledModel 加载失败的典型现象
加载后应用启动直接崩溃，常见错误不是“找不到文件”，而是以下两类：
-
System.IO.FileNotFoundException: Could not load file or assembly 'Microsoft.EntityFrameworkCore.Relational, Version=9.0.0...'—— 缺少Microsoft.EntityFrameworkCore.Relational引用，该程序集含CompiledModel.Create()所需类型，仅引用SqlServer不够； -
InvalidOperationException: The compiled model is not compatible...—— 最常被忽略的是 DbContext 的[DbContext(typeof(YourContext))]特性未保留，或生成时用了 Debug 配置而运行时是 Release，导致内部RuntimeModel初始化逻辑不一致。
验证是否加载成功：在 DbContext.OnConfiguring 中加一行 Console.WriteLine(optionsBuilder.IsModelCached ? "✅ cached" : "❌ fallback");，只有真正命中缓存才说明生效。
Compiled Model 和 NativeAOT 能不能一起用
能，但必须分两步走，且顺序不能错：
- 先启用
<publishaot>true</publishaot>并添加Microsoft.EntityFrameworkCore.Tasks包，它会在发布阶段自动触发dotnet ef dbcontext optimize并嵌入模型； - 再手动在
DbContextOptionsBuilder中调用.UseCompiledModel(...)—— 注意：AOT 发布不会自动注入该调用，必须自己写； - 关键限制：
Microsoft.EntityFrameworkCore.Tasks目前只支持 SQL Server 和 Npgsql，SQLite 不支持预编译模型嵌入。
如果同时启用了 AOT 和手动 UseCompiledModel，EF Core 会优先使用嵌入的模型；但若嵌入失败（比如 Provider 不匹配），仍会回退到运行时构建——此时你根本不知道它没生效。
比 Compiled Model 更容易落地的替代方案
如果你的项目无法严格锁定构建/运行环境，或团队缺乏 CI 控制权，以下两个方案更稳：
- 用
static IModel缓存 +UseModel()：在 DbContext 外部一次性构建并复用模型，不依赖二进制兼容性，适用于 .NET 6+； - 启用上下文池（
AddDbContextPool<t>()</t>）：把初始化成本摊到整个生命周期，对高频创建场景（如 gRPC 服务）效果明显，且无版本绑定风险。
Compiled Model 真正的价值不在“快”，而在“确定性”——它把模型构建从不可控的运行时反射，变成可测试、可版本化、可 diff 的构建产物。一旦你开始做容器镜像分层或 Serverless 冷启压测，这点就绕不过去。
