Dapper 查询返回 dynamic 类型本质是映射为 ExpandoObject 集合，适用于结构不确定的查询，但存在性能与类型安全风险；推荐结构明确时使用实体类或匿名类型。
Dapper 查询返回 dynamic 类型，本质上是让 Dapper 自动将每一行结果包装成一个 ExpandoObject（动态对象），字段名作为属性名，值作为属性值。这种方式适合不确定结构的查询（比如 SELECT *、多表拼接、运行时构造 SQL），但要注意性能和类型安全问题。
用 Query 获取动态结果
直接调用 Query 方法，Dapper 会自动映射为 ExpandoObject 的集合：
-
写法示例：var rows = conn.Query
("SELECT Id, Name, CreatedTime FROM Users WHERE Status = @status", new { status = 1 }); - 返回的是
IEnumerable，遍历时可直接访问属性，如row.Id、row.Name - 如果字段名含空格或特殊字符（如
First Name），需用方括号语法：row["First Name"]
动态对象的属性访问与注意事项
dynamic 对象在编译期不检查属性是否存在，运行时才解析，容易出错：
- 访问不存在的属性会抛
RuntimeBinderException，建议加try/catch或先判断：if (row is IDictionarydict && dict.ContainsKey("Age")) { ... } - 不能用
var x = row.Age;然后直接传给强类型方法——除非目标方法参数也是dynamic，否则会编译失败或运行时报错 - 数值类型默认是
object，需要显式转换：(int)row.Id或Convert.ToInt32(row.Id)
替代方案：用匿名类型更安全（推荐用于已知结构）
如果只是临时用、结构固定，用匿名类型比 dynamic 更清晰、有 IDE 提示、编译期检查：
- var rows = conn.Query("SELECT Id, Name FROM Users").Select(x => new { Id = x.Id, Name = x.Name });
- 或者直接
Query不行，但可以写成：var rows = conn.Query("SELECT Id, Name FROM Users").Select(x => new { x.Id, x.Name }); - 缺点：无法跨方法传递（匿名类型是 internal 的），适合局部快速处理
进阶：手动构建 ExpandoObject（按需动态列）
当列名完全由变量控制（比如用户自定义报表字段），可用 IDataReader + 手动读取：
- 用
conn.ExecuteReader(sql)获得IDataReader - 遍历
reader.FieldCount，用reader.GetName(i)和reader.GetValue(i)构建ExpandoObject - 这样能完全控制映射逻辑，比如跳过 NULL 字段、重命名列、类型预处理等
基本上就这些。用 dynamic 是为了灵活，不是为了偷懒；结构明确时优先用实体类或匿名类型，既快又稳。
