You need to enable JavaScript to run this app. .NET Core FromSqlRaw调用存储过程时JSON数组绑定为空问题
优惠活动
大模型
产品
解决方案
定价
更多

.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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 16:54:08