FreeSql中JsonMap列更新问题的分析与解决方案

问题背景

在使用FreeSql ORM框架时，开发者可能会遇到一个关于JsonMap列更新的特殊问题：当实体类中包含Dictionary<string,class>类型的属性并使用JsonMap特性标记时，只有第一次插入操作能成功保存数据，后续的更新操作虽然不报错，但JsonMap列的内容却不会被更新。

问题现象

具体表现为：

1. 首次调用InsertOrUpdate方法时，JsonMap列能够正常保存到数据库
2. 后续调用InsertOrUpdate方法时，虽然LastModified等普通字段能够正常更新，但JsonMap列内容保持不变
3. 整个过程没有任何错误提示，给调试带来困难

问题分析

这个问题的根本原因在于FreeSql的更新机制。FreeSql在判断实体是否需要更新时，会对比新旧值的变化。然而对于引用类型（如Dictionary），这种比较是基于引用地址而非内容值的。当开发者修改字典内容但保持字典实例不变时，FreeSql无法检测到实际发生的变化，因此不会生成更新语句。

解决方案

临时解决方案

1. 创建新实例：每次修改字典内容后，创建一个新的字典实例赋值给属性。这样FreeSql能够检测到引用变化，从而触发更新。

// 修改字典内容后
corpProducerRelation.CorpProducerRanks = new Dictionary<string, CorpProducerRank>(corpProducerRelation.CorpProducerRanks);

2. 手动标记脏字段：使用FreeSql的Update方法并明确指定要更新的字段。

repoCorpProducerRelation.Update<CorpProducersRelation>()
    .Set(x => x.CorpProducerRanks, corpProducerRelation.CorpProducerRanks)
    .Where(x => x.Id == corpProducerRelation.Id)
    .ExecuteAffrows();

长期建议

1. 考虑使用值类型：如果可能，将字典中的值类型改为结构体(struct)，因为结构体是按值比较的。

2. 实现自定义比较：可以继承FreeSql的基类并重写比较逻辑，实现基于内容的比较而非引用比较。

3. 等待框架改进：关注FreeSql的更新，未来版本可能会提供更灵活的更新检测机制。

最佳实践

在实际开发中，建议：

1. 对于频繁更新的JsonMap列，考虑使用单独的更新方法
2. 在修改引用类型属性后，主动创建新实例
3. 添加日志记录，帮助调试更新操作
4. 考虑将复杂对象拆分为多个简单属性，减少引用类型的使用

总结

FreeSql作为一款优秀的ORM框架，在处理简单数据类型时表现良好，但在处理复杂引用类型时需要注意其更新机制。理解框架的工作原理并采取适当的应对措施，可以避免这类问题的发生。开发者应根据实际业务场景选择最适合的解决方案，平衡开发效率和性能需求。