Dapper 默认不支持直接映射仅含 private set 的复杂类型属性，需通过 public setter 封装校验逻辑、注册 CustomPropertyTypeMap、使用 AS 别名配合 dynamic/匿名对象读取，或显式传参执行写操作。
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>，再手动构造目标对象 - 适合报表、DTO 映射等一次性场景，灵活但稍冗余
插入/更新时用匿名对象或 ExpandoObject
写操作无法靠私有 setter 自动填充，推荐显式传参：
- 插入：
connection.Execute("INSERT INTO book (name, author) VALUES (@name, @author)", new { name = book.Name, author = book.Author }) - 避免传整个实体，而是提取需要的字段组成轻量对象
- 配合
SqlMapper.Bind或自定义扩展方法可封装复用逻辑
基本上就这些。核心原则是：Dapper 优先契约胜于魔法——它不强制你改模型，但需要你明确告诉它“怎么设值”。选哪种方式，取决于你对封装强度、可维护性和团队规范的权衡。
