为什么查询使用dapper将一些空值返回给我的列表对象

关于Dapper返回空值到列表对象的问题

基础概念

Dapper是一个轻量级的ORM（对象关系映射器），用于.NET应用程序与数据库之间的数据交互。它通过扩展IDbConnection接口提供高效的数据库查询功能。

问题原因分析

当使用Dapper查询数据库并将结果映射到列表对象时遇到空值，可能有以下几种原因：

数据库字段为NULL：查询结果中某些字段在数据库中是NULL值
列名不匹配：数据库列名与对象属性名不匹配导致映射失败
类型不匹配：数据库字段类型与对象属性类型不兼容
查询结果为空：查询条件导致没有匹配的记录
对象初始化问题：对象构造函数或初始化逻辑导致属性被设为null

解决方案

1. 检查数据库数据

首先确认数据库中查询的数据是否确实包含NULL值：

var results = connection.Query<dynamic>("SELECT * FROM YourTable WHERE YourCondition");
foreach(var row in results)
{
    Console.WriteLine(row.YourColumn); // 检查哪些列是null
}

2. 处理NULL值映射

如果数据库确实有NULL值，可以：

使用可为空类型(Nullable<T>)
在属性上设置默认值
使用Dapper的DefaultValue特性

public class YourModel
{
    // 使用可为空类型
    public int? NullableIntProperty { get; set; }
    
    // 设置默认值
    public string StringProperty { get; set; } = string.Empty;
    
    // 使用DefaultValue特性
    [DefaultValue(0)]
    public int DefaultIntProperty { get; set; }
}

3. 确保列名匹配

确保数据库列名与对象属性名匹配，或使用别名：

// SQL中使用AS别名匹配属性名
var results = connection.Query<YourModel>("SELECT db_column AS ModelProperty FROM YourTable");

// 或者使用Dapper的Column映射特性
public class YourModel
{
    [Column("db_column")]
    public string ModelProperty { get; set; }
}

4. 处理空结果集

检查查询是否返回了任何数据：

var results = connection.Query<YourModel>("...").ToList();
if(!results.Any())
{
    // 处理无数据情况
}

5. 使用自定义类型处理器

对于复杂场景，可以创建自定义类型处理器：

public class NullableIntHandler : SqlMapper.TypeHandler<int?>
{
    public override void SetValue(IDbDataParameter parameter, int? value)
    {
        parameter.Value = value ?? (object)DBNull.Value;
    }

    public override int? Parse(object value)
    {
        return value == DBNull.Value ? null : (int?)value;
    }
}

// 注册处理器
SqlMapper.AddTypeHandler(new NullableIntHandler());

最佳实践

始终使用参数化查询防止SQL注入
为可能为NULL的数据库字段使用可为空类型
在查询前验证连接状态
考虑使用Dapper的QueryFirstOrDefault或QuerySingleOrDefault方法处理可能为空的结果
添加适当的日志记录以帮助调试

示例代码

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; } = string.Empty; // 默认值
    public decimal? Price { get; set; } // 可为空
    [Column("desc")] // 映射到不同列名
    public string Description { get; set; } = string.Empty;
}

public IEnumerable<Product> GetProducts(int categoryId)
{
    using var connection = new SqlConnection(connectionString);
    
    return connection.Query<Product>(
        @"SELECT id, name, price, description AS [desc] 
        FROM products 
        WHERE category_id = @CategoryId 
        AND is_active = 1",
        new { CategoryId = categoryId });
}

通过以上方法，您应该能够解决Dapper返回空值到列表对象的问题。