报错：后端返回的Nullable对象必须包含值，求排查思路

这个错误通常是因为尝试访问**可为空值类型（Nullable）**的Value属性，但该类型当前为null导致的。结合你的代码，按以下步骤排查：

1. 先获取完整异常堆栈跟踪 #

你的日志仅记录了错误消息，建议修改日志代码记录完整的异常信息（比如logger.Error(e.ToString())）。堆栈跟踪会直接指出错误发生的具体代码行，是在数据库查询阶段还是实体映射到UserInfo的阶段，这是最快定位问题的方式。

2. 检查UserInfo的构造函数 #

错误大概率出现在new Data.Models.UserInfo(entity)这一步。请查看UserInfo的构造实现：

• 是否存在将User实体中的可为空值类型（比如int?、DateTime?）直接赋值给UserInfo中非空值类型属性的情况？
• 例如：如果User有DateTime? BirthDate，而UserInfo的BirthDate是DateTime，当数据库中该字段为null时，直接取entity.BirthDate.Value就会触发这个错误。

3. 验证数据库查询结果 #

在entities = dbContext.User.Where(...).ToList();之后添加断点，查看返回的entities集合：

• 检查每个User实体的可为空值类型属性，是否有null的情况？
• 注意：你的Where条件只过滤了LastName非空，但其他字段可能存在null值。

4. 修复方案示例 #

如果是映射阶段的问题，修改UserInfo构造函数或映射逻辑，处理可为空值：

// 示例：给可为空字段设置默认值，或先判断是否有值
public UserInfo(User entity)
{
    // 处理字符串（本身可为空，无需额外操作）
    this.LastName = entity.LastName;
    // 处理可为空值类型，比如DateTime?
    this.BirthDate = entity.BirthDate ?? DateTime.MinValue; // 用默认值替代null
    // 或者如果允许UserInfo的BirthDate也可为空，直接赋值
    // this.BirthDate = entity.BirthDate;
    // 另一种方式：先判断是否有值
    if (entity.Age.HasValue)
    {
        this.Age = entity.Age.Value;
    }
    else
    {
        this.Age = 0; // 或其他合理默认值
    }
}

5. 检查数据库与实体类映射 #

确认User实体类的属性是否正确映射数据库字段的可空性：

• 如果数据库中某字段允许null，实体类对应的属性应该声明为可为空值类型（比如int?而非int）；
• 反之，如果数据库字段不允许null，实体类属性应为非空类型，避免不必要的空值判断。

内容的提问来源于stack exchange，提问作者GHOST