.NET Core FromSqlRaw调用存储过程时JSON数组绑定为空问题
问题根因
- EF Core 3.1 的
FromSqlRaw仅支持将数据库返回的列直接映射为模型的基础类型属性,不会自动识别字符串格式的JSON内容,更不会自动反序列化为自定义嵌套集合类型 - 原代码存在基础映射错误:存储过程返回的
Id、Email列名,与定义的IdContact、Company属性名不匹配,EF无法完成对应绑定 - 直接将数据库中字符串类型的
Numbers列绑定为IEnumerable<SearchContactsNumber>复杂类型,超出了EF Core 3.1的原生映射能力,最终只会返回空集合 - 将带嵌套复杂类型的
SearchContacts作为DbSet使用时,未配置无键实体规则,EF无法正确识别存储过程返回的结果结构
修复步骤
1. 拆分原始映射模型与业务模型
先定义专门匹配存储过程返回结构的原始映射类,所有属性均为EF可直接转换的基础类型,不包含复杂嵌套类型:
// 专门用于承接存储过程原始返回的无键实体 public sealed class SearchContactsRaw { // 对应存储过程返回的 Id VARCHAR(36),EF可自动将字符串格式的GUID转为Guid类型 public Guid Id { get; set; } public string FirstName { get; set; } public string LastName { get; set; } // 对应存储过程返回的 Email 列 public string Email { get; set; } // 先将JSON格式的Numbers列映射为字符串,不做复杂类型转换 public string Numbers { get; set; } }
你原有的带嵌套Numbers集合的SearchContacts类保留,作为最终返回给调用方的业务模型即可,不需要作为DbSet使用。
2. 配置DbContext的无键实体映射
在你的DbContext的OnModelCreating方法中,将上述原始类配置为无键实体(不需要对应数据库物理表),解决EF无法识别存储过程结果的问题:
protected override void OnModelCreating(ModelBuilder modelBuilder) { modelBuilder.Entity<SearchContactsRaw>(entity => { // 声明该实体无主键,不绑定数据库物理表 entity.HasNoKey(); // 如存在列名与属性名不一致的情况,可在此显式配置映射关系 // 例:entity.Property(e => e.Id).HasColumnName("Id"); }); }
3. 调整控制器逻辑,内存内完成JSON反序列化
调用存储过程时先把原始结果拉取到内存,再手动将Numbers字段的JSON字符串反序列化为目标集合,生成最终的业务模型:
public IActionResult Index() { // 1. 调用存储过程获取原始结果,立即ToList将数据加载到内存 var rawResults = _context.Set<SearchContactsRaw>() .FromSqlRaw("CALL `SearchContacts`()") .ToList(); // 2. 内存层完成字段映射与JSON反序列化,生成目标业务模型 var contacts = rawResults.Select(raw => new SearchContacts { IdContact = raw.Id, FirstName = raw.FirstName, LastName = raw.LastName, Company = raw.Email, // 对应你原模型中Company属性的取值 // 处理Numbers为NULL/空串的边界场景,避免反序列化报错 Numbers = string.IsNullOrWhiteSpace(raw.Numbers) ? Enumerable.Empty<SearchContactsNumber>() : System.Text.Json.JsonSerializer.Deserialize<List<SearchContactsNumber>>(raw.Numbers) }).ToList(); return Ok(contacts); }
注意事项
- 必须在
FromSqlRaw后立即执行ToList()将数据加载到内存,否则后续的Select投影逻辑会被EF尝试翻译成SQL语句,直接执行报错 - 不要试图让EF Core 3.1直接将字符串列映射为嵌套集合类型,该版本对自定义值转换器支持有限,硬实现容易出现映射失败的问题,内存层反序列化的方式稳定性最高
- 如果你的存储过程中
Numbers列是MySQL原生JSON类型,上述逻辑完全兼容,Pomelo 3.2.3默认会将JSON类型字段映射为字符串处理 - 反序列化JSON时,注意System.Text.Json默认大小写敏感,如果JSON字段名与类属性名存在大小写差异,可通过
[JsonPropertyName("字段名")]特性显式绑定,避免反序列化后属性值为空
内容的提问来源于stack exchange,提问作者ewhoambra
相关产品推荐
相关产品推荐

