Dapper 默认不支持直接映射到仅含 private set 的属性，尤其当属性类型是复杂对象（如自定义类）时。它能自动处理带 private set 的基础类型（如
string、
int、
DateTime），但对只读属性（
get;无
set）或私有 setter 不可达的场景，需额外干预。
用 public setter + 封装逻辑替代
最简单稳妥的做法是把 setter 设为 public，再在内部加保护逻辑，既满足 Dapper 映射，又不破坏业务约束：
例如：public string Name { get; set { _name = string.IsNullOrWhiteSpace(value) ? throw new ArgumentException("Name required") : value.Trim(); } }
避免完全暴露字段，而是把校验/转换逻辑放进 setter 中
适用于多数业务实体，开发和调试都直观
注册 CustomPropertyTypeMap 实现私有 setter 映射
当必须保留 strict 封装（如 DDD 领域模型），可用
SqlMapper.SetTypeMap注册自定义映射器，显式告诉 Dapper 如何设置私有属性： 创建
CustomPropertyTypeMap子类，重写
GetSetMethod，返回对应私有 setter 的
MethodInfo调用
SqlMapper.SetTypeMap(typeof(YourEntity), new YourCustomMap())全局注册 注意：Dapper 6.0+ 对私有 setter 支持增强，但仍不自动识别复杂类型赋值，需确保 setter 可被反射访问（如非
private protected）
查询阶段用 AS 别名 + 动态/匿名对象过渡
如果只是读取（SELECT），不依赖强类型实体，可绕过 setter 限制：
SQL 中用AS对齐属性名：
SELECT create_time AS CreateTime FROM book先查为
dynamic或
IDictionary<string object></string>，再手动构造目标对象 适合报表、DTO 映射等一次性场景，灵活但稍冗余
插入/更新时用匿名对象或 ExpandoObject
写操作无法靠私有 setter 自动填充，推荐显式传参：
插入：connection.Execute("INSERT INTO book (name, author) VALUES (@name, @author)", new { name = book.Name, author = book.Author })
避免传整个实体，而是提取需要的字段组成轻量对象
配合 SqlMapper.Bind或自定义扩展方法可封装复用逻辑
基本上就这些。核心原则是：Dapper 优先契约胜于魔法——它不强制你改模型，但需要你明确告诉它“怎么设值”。选哪种方式，取决于你对封装强度、可维护性和团队规范的权衡。
