EF Core值转换器能解决什么问题
当你的C#模型里有
TimeOnly、
DateOnly、枚举类、JSON对象（如
Dictionary<string object></string>）、或自定义结构体（如
Money）时，EF Core默认不支持直接映射到数据库列。值转换器（
ValueConverter）就是用来在读写时自动做类型转换的——比如把
TimeOnly转成
TimeSpan存进
time列，或把
Money序列化为
decimal或
nvarchar。
如何注册一个基础的值转换器（以TimeOnly
为例）
EF Core 6+原生支持
TimeOnly和
DateOnly，但如果你用的是老版本，或想自定义行为（比如统一转为
datetime2列并忽略日期部分），就得手动配转换器。关键点是：转换必须双向、无副作用、线程安全。
常见做法是在
OnModelCreating中为特定属性配置：
modelBuilder.Entity<Order>()
.Property(e => e.ShipTime)
.HasConversion(
timeOnly => timeOnly.ToTimeSpan(), // 写入时：TimeOnly → TimeSpan
timeSpan => TimeOnly.FromTimeSpan(timeSpan) // 读取时：TimeSpan → TimeOnly
);
注意：
ToTimeSpan()会丢失毫秒精度（
TimeOnly支持微秒，
TimeSpan在SQL Server
time列中只保留到100纳秒）。如果精度敏感，建议用
string或
long（ticks）做中间类型。
自定义结构体（如Money
）怎么映射
假设你有不可变结构体
Money，含
Amount（
decimal）和
Currency（
string），但只想存
Amount到数据库一列（如
Price），忽略货币单位： 必须提供无参构造函数或确保EF Core能实例化（否则读取失败） 转换逻辑不能依赖外部状态（比如不能调用
DateTime.Now） 推荐用
ValueConverter<money decimal></money>，而非
string，避免解析开销
示例：
modelBuilder.Entity<Product>()
.Property(p => p.Price)
.HasConversion(
money => money.Amount,
amount => new Money(amount, "USD") // 默认币种可硬编码，或从上下文注入（需额外设计）
);
如果需要存币种，就得用
JsonSerializer转成
string，但要注意：JSON列无法被SQL索引或高效查询，仅适合只读或低频检索场景。
值转换器 vs 值生成器 vs 自定义类型映射
别混淆这几个概念：
HasConversion()是值转换器：处理「同一属性」的读写类型变换，不改数据库列类型
HasDefaultValue()或
HasComputedColumnSql()是值生成器：控制「插入/更新时数据库侧怎么填值」 真正改变列类型（比如让
enum存为
varchar而非
int），要用
HasConversion()+
HasColumnType("nvarchar(20)")
最容易踩的坑是：在转换函数里调用
ToString()或
new DateTime()这类可能抛异常的方法，导致查询时静默失败；还有就是忘记设置
IsUnicode(false)或
HasMaxLength(50)，让字符串列过长拖慢性能。
复杂点在于，一旦用了值转换器，LINQ查询里的
Where条件就受限于数据库能否翻译该转换逻辑——比如
Where(x => x.ShipTime.Hour > 12)在没注册表达式转换器时，会被拉到内存执行，而不是下推到SQL。
