Dapper 默认不支持只写属性映射,因其在反序列化前通过 PropertyInfo.CanRead 过滤属性,跳过无 get 的属性;虽 SetValue 支持赋值,但前期元数据筛选已排除。

Dapper 默认不支持只写属性(即只有 set、没有 get 的属性)的映射,因为它在反序列化时需要通过属性的 set 方法赋值,但同时也依赖反射获取属性元数据——而标准 .net 反射对纯只写属性的支持有限,尤其在旧版 Dapper(如 2.0 之前)中会直接跳过这类属性,导致映射失败或静默忽略。
只写属性 为什么 通常映射不了
Dapper 在执行查询后,使用 PropertyInfo.SetValue() 给目标 对象 赋值,这一步本身能接受只写属性。但问题出在前期:它会先调用 PropertyInfo.CanRead 判断是否为可读属性,默认过滤掉 CanRead == false 的属性。所以即使你写了 set,只要没 get,Dapper 就不会把它纳入映射字段列表。
绕过限制的实用方法
- 改用带 get 的属性:最简单可靠的方式。哪怕
get返回默认值或 throw,只要存在且可访问,Dapper 就能识别。例如:public String Name {get => throw new NotSupportedException(); set {_name = value;} } - 用 sql 别名 + 匿名对象中转:先查到匿名类型或
Dictionary<string Object></string>,再手动给只写属性赋值。适合少量字段或初始化场景。 - 自定义
ITypeMap实现 :重写GetMember(string columnName),主动返回只写属性的PropertyInfo,并确保CanRead不作为硬性过滤条件。需 继承SqlMapper.ITypeMap并注册:SqlMapper.SetTypeMap(typeof(MyDto), new MyCustomTypeMap()); - 避免只写属性用于查询映射:设计上建议 DTO 或实体只暴露需要读取的属性;只写逻辑(如密码哈希、审计时间戳)更适合放在插入 / 更新时由业务层控制,而非依赖查询结果自动填充。
插入 / 更新时的只写属性处理
对于 Insert 或 Update 操作,Dapper 仅用 PropertyInfo.GetValue() 提取参数值,这时只写属性因无法 GetValue 会报错或传 NULL。所以 只写属性不应出现在 Insert/Update 的参数对象中。正确做法是:
基本上就这些。Dapper 的设计哲学偏向“约定优于配置”,对非常规结构支持有限,只写属性属于边缘场景,优先调整模型设计比硬扛映射更可持续。