Mapperly 项目中用户自定义映射方法解析问题分析

问题背景

在 Mapperly 这个对象映射工具的最新版本中，开发者发现了一个关于用户自定义映射方法解析的问题。当启用引用处理(Reference Handling)功能时，Mapperly 生成的代码会出现不符合预期的行为，特别是在处理带有忽略属性的映射方法时。

问题现象

开发者定义了一个包含多个映射方法的 Mapper 类，其中特别为 SourceC 到 TargetC 的转换定义了忽略 Name 属性的映射规则。然而，当启用引用处理后，生成的代码出现了以下异常情况：

1. 生成了两个不同的 MapToTargetC 方法
2. 其中一个方法(MapToTargetC1)正确地忽略了 Name 属性
3. 但另一个方法(MapToTargetC)却错误地包含了 Name 属性的映射
4. 这种不一致导致在集合映射时使用了错误的映射方法

技术分析

经过深入分析，这个问题源于 Mapperly 在启用引用处理时的映射方法解析逻辑缺陷。具体表现为：

1. 方法解析失败：当处理 SourceB.CList 到 TargetB.CList 的集合映射时，Mapperly 未能正确识别用户自定义的 ToTargetFrom(SourceC) 方法
2. 自动生成冲突：由于未能识别用户自定义方法，Mapperly 自动生成了一个新的映射方法，且没有应用用户定义的忽略规则
3. 命名冲突：系统生成了 MapToTargetC 和 MapToTargetC1 两个方法，导致代码冗余和潜在的行为不一致

解决方案

该问题已在 Mapperly 3.5.0-next.2 版本中得到修复。修复后的行为表现为：

1. 正确的方法解析：现在能够正确识别用户自定义的映射方法
2. 一致的属性处理：确保所有映射路径都遵循用户定义的忽略规则
3. 消除冗余代码：不再生成多余的映射方法

开发者建议

对于遇到类似问题的开发者，可以考虑以下临时解决方案：

1. 暂时禁用引用处理功能
2. 手动在所有映射方法中添加 ReferenceHandler 参数
3. 调整方法定义顺序（虽然不推荐作为长期方案）

总结

这个问题的修复提高了 Mapperly 在处理复杂映射场景时的稳定性和可靠性，特别是对于需要精细控制属性映射的场景。开发者现在可以更放心地使用引用处理功能，而不必担心自定义映射规则被意外忽略。