Mapperly项目中的MapProperty与IQueryable投影问题解析

问题背景

在Mapperly 3.6.0版本中，开发人员发现了一个关于MapProperty特性与IQueryable投影功能的重要回归问题。当项目未启用Nullable引用类型时，MapProperty特性在IQueryable投影场景下无法正确生成映射代码。

问题表现

具体表现为，当开发者使用MapProperty特性定义属性映射关系时，生成的IQueryable投影代码会忽略这些映射关系。例如，在将Car.Manufacturer映射到CarDto.Producer的场景中，3.6.0版本生成的投影代码会遗漏Producer属性的映射，而3.5.1版本则能正确生成。

技术分析

这个问题实际上是一个功能回归，与之前修复的#1196号问题相关。在3.6.0版本中，当Nullable引用类型未启用时，代码生成器在处理IQueryable投影时未能正确识别MapProperty特性定义的映射关系。

解决方案

Mapperly团队已经在4.1.1-next.0预览版本中修复了这个问题。经过社区测试验证，该修复版本能够正确生成包含MapProperty映射关系的投影代码。

开发者建议

对于遇到此问题的开发者，建议：

1. 暂时停留在3.5.1版本
2. 或者升级到包含修复的4.1.1-next.0预览版本
3. 等待4.1.1正式版发布后升级

总结

这个案例提醒我们，在升级映射工具版本时需要特别注意功能兼容性，特别是当项目使用特殊配置（如禁用Nullable引用类型）时。Mapperly团队对社区反馈响应迅速，值得肯定。