Mapperly项目中的泛型类私有属性映射异常问题分析

问题背景

在使用Mapperly这一强大的对象映射工具时，开发者遇到了一个关于泛型类私有属性映射的特殊问题。当尝试映射一个泛型基类中的受保护属性时，生成的代码在.NET 9环境下会抛出"Method not found"异常。

问题复现场景

考虑以下类结构设计：

public class Entity<TKey>
{
    public TKey Id { get; protected set; }
}

public class Student : Entity<Guid>
{
    public Student()
    {
        Id = Guid.NewGuid();
    }

    public int EntityVersion { get; protected set; } = 1;
}

对应的DTO类：

public class StudentEto
{
    public Guid Id { get; set; }
    public int EntityVersion { get; set; }
}

当使用Mapperly配置映射时：

[Mapper(RequiredMappingStrategy = RequiredMappingStrategy.Both, IncludedMembers = MemberVisibility.All)]
public static partial class Mapper
{
    public static partial Student MapperToStudent(StudentEto source);
}

问题本质分析

问题的核心在于.NET 9对UnsafeAccessor机制的改进。在.NET 9之前，UnsafeAccessor可以相对自由地访问泛型类型的成员，但从.NET 9开始，为了类型安全考虑，对泛型类型的成员访问有了更严格的限制。

当前Mapperly生成的代码中，对于泛型基类Entity的Id属性setter方法，生成的UnsafeAccessor是直接针对Entity类型的，这在.NET 9中会导致运行时异常。

技术解决方案

正确的实现方式应该是为泛型类型创建对应的泛型UnsafeAccessor类。具体来说：

1. 为普通类型(如Student)的非泛型成员创建非泛型的UnsafeAccessor
2. 为泛型类型(如Entity)的成员创建泛型的UnsafeAccessor

这样生成的代码结构更符合.NET 9的类型安全要求，也能正确访问泛型类中的受保护成员。

对开发者的建议

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

1. 暂时降级到.NET 8环境运行
2. 为需要映射的泛型类显式提供公共的setter方法
3. 考虑使用接口或抽象方法来暴露必要的属性访问

长期来看，等待Mapperly更新以支持.NET 9的UnsafeAccessor新规范是最佳选择。

总结

这个问题展示了类型系统演进过程中可能遇到的兼容性挑战。Mapperly作为一个强大的代码生成工具，需要不断适应底层平台的变化。理解这类问题的本质有助于开发者更好地使用代码生成工具，并在遇到类似问题时能够快速定位原因。