EF Core 不能在 Blazor WebAssembly 客户端直接运行，因其依赖的 ADO.NET、同步 I/O 等能力不被浏览器沙箱支持；必须部署于服务端，由 Blazor WASM 通过 HTTP API 调用访问数据。
EF Core 不能直接在 Blazor WebAssembly（WASM）客户端运行，因为 WASM 运行在浏览器沙箱中，没有访问本地数据库或执行同步 I/O 的能力。所以EF Core 必须放在服务端（Server 项目）中使用，Blazor WASM 客户端通过 HTTP 调用 API 获取数据——这是官方推荐且唯一可行的集成方式。
为什么不能在 WASM 客户端直接用 EF Core
EF Core 依赖 .NET 运行时的底层能力（如 ADO.NET、文件系统、网络套接字），而 Blazor WASM 使用的是 WebAssembly .NET 运行时，不支持：
- 直接连接 SQL Server、SQLite 或其他数据库驱动
- 同步数据库连接与事务管理
- Entity Framework 的迁移命令（
dotnet ef migrations）无法在浏览器中执行
标准集成结构：Client + Server 分离
典型项目结构是 Blazor WebAssembly Hosted 模式（含 Client、Server、Shared 三个子项目）：
-
Client：纯前端，用
HttpClient调用 Server 的控制器 API - Server：ASP.NET Core Web API，引用 EF Core，配置 DbContext，实现数据访问逻辑
- Shared：存放共享模型（DTO 或实体类），避免重复定义
例如，获取联系人列表：Client 发起 GET /api/contacts → Server 中的 ContactsController 使用 ContactContext 查询并返回 JSON。
关键配置步骤
以官方模板为基础，需完成以下操作：
- 在 Server 项目中安装
Microsoft.EntityFrameworkCore.SqlServer（或其他提供程序） - 在
Program.cs中注册 DbContext：builder.Services.AddDbContext(opt => opt.UseSqlServer(connStr)) - 添加控制器，方法返回
IActionResult，内部调用> _context.Contacts.ToListAsync() - Client 中注入
HttpClient，用GetFromJsonAsync拉取数据- >("api/contacts")
- 确保跨域（CORS）已为 Client 域名启用（开发时通常是
https://localhost:5001）
进阶注意点
实际落地时容易忽略但影响体验的关键项：
- 不要把 EF 实体直接暴露给 Client，用 DTO 隔离，避免序列化循环引用或敏感字段泄漏
- 分页、筛选、排序应在 Server 端做（用
Skip/Take、Where等），而非拉全量到前端处理 - 数据库连接字符串必须只存在于 Server 的
appsettings.json，绝不可硬编码或泄露到 Client - 若需离线支持，可配合 IndexedDB + 同步策略（如 PWA + custom sync logic），但这和 EF Core 无关，属于前端状态缓存范畴
基本上就这些。核心就一条：EF Core 是服务端的事，Blazor WASM 只负责展示和发起请求。设计清晰、职责分明，才能稳定高效。
