使用反射动态设置PaymentMethodDto属性失败问题排查

核心问题分析 #

1. 测试实例未关联AsyncLocal
   测试代码中创建了PaymentMethodDto实例，但从未将其赋值给PaymentMethodHelper.EntityDto，导致反射操作的是AsyncLocal中默认初始化的空结构体实例，和断言的对象完全无关。

2. 值类型的副本特性
   PaymentMethodDto是值类型（struct），获取asyncLocalEntityDto.Value时会返回结构体的副本，直接修改副本的属性不会影响原存储在AsyncLocal中的实例。

3. Positional Record Struct的属性限制
   通过 positional 参数定义的record struct，生成的属性默认是init修饰的，仅能在实例初始化阶段赋值，后续无法通过常规SetValue修改（即使PropertyInfo.CanWrite返回true，运行时也会抛出异常，你这里没触发是因为操作的是未关联的空实例）。

修复方案 #

1. 修正测试代码，关联AsyncLocal实例

确保测试中操作的实例和AsyncLocal中存储的是同一个对象：

[Fact]
public void SetEntityProperty_SetIdProperty_ShouldSetIdCorrectly()
{
    // Arrange
    var dto = new PaymentMethodDto();
    PaymentMethodHelper.EntityDto = dto; // 将实例关联到AsyncLocal

    // Act
    PaymentMethodHelper.SetEntityProperty(nameof(PaymentMethodDto.Id), 100);

    // Assert
    Assert.Equal(100, PaymentMethodHelper.EntityDto.Id); // 断言AsyncLocal中的实例
}

[Fact]
public void SetEntityProperty_SetPersonIdProperty_ShouldSetPersonIdCorrectly()
{
    // Arrange
    var dto = new PaymentMethodDto();
    PaymentMethodHelper.EntityDto = dto;

    // Act
    PaymentMethodHelper.SetEntityProperty(nameof(PaymentMethodDto.PersonId), 200);

    // Assert
    Assert.Equal(200, PaymentMethodHelper.EntityDto.PersonId);
}

2. 适配Record Struct的不可变特性修改SetEntityProperty方法

因为record struct的属性是init-only，无法直接修改现有实例，需要创建新实例并替换AsyncLocal中的值。以下提供两种实现方式：

方式一：利用Record的With表达式（简洁直观）

public static void SetEntityProperty(string propertyName, object propertyValue)
{
    var currentDto = asyncLocalEntityDto.Value;
    if (currentDto == null)
        throw new InvalidOperationException("EntityDto未初始化");

    var propertyType = typeof(PaymentMethodDto).GetProperty(propertyName)?.PropertyType;
    if (propertyType == null)
        throw new ArgumentException($"Property '{propertyName}' not found in PaymentMethodDto");

    var convertedValue = Convert.ChangeType(propertyValue, propertyType);
    PaymentMethodDto newDto = propertyName switch
    {
        nameof(PaymentMethodDto.Id) => currentDto with { Id = (int?)convertedValue },
        nameof(PaymentMethodDto.PersonId) => currentDto with { PersonId = (int)convertedValue },
        nameof(PaymentMethodDto.BenefitTypeId) => currentDto with { BenefitTypeId = (BenefitTypeEnum)convertedValue },
        nameof(PaymentMethodDto.User) => currentDto with { User = (string)convertedValue },
        nameof(PaymentMethodDto.StartDate) => currentDto with { StartDate = (DateTime?)convertedValue },
        nameof(PaymentMethodDto.EndDate) => currentDto with { EndDate = (DateTime?)convertedValue },
        _ => throw new ArgumentException($"Property '{propertyName}' not supported")
    };

    asyncLocalEntityDto.Value = newDto;
}

方式二：通用反射创建新实例（无需硬编码属性）

public static void SetEntityProperty(string propertyName, object propertyValue)
{
    var type = typeof(PaymentMethodDto);
    var targetProperty = type.GetProperty(propertyName);
    if (targetProperty == null)
        throw new ArgumentException($"Property '{propertyName}' not found in PaymentMethodDto");

    var currentDto = asyncLocalEntityDto.Value;
    // 获取所有属性的当前值，替换目标属性的值
    var allProperties = type.GetProperties();
    var propertyValues = allProperties.Select(p => 
        p.Name == propertyName ? Convert.ChangeType(propertyValue, p.PropertyType) : p.GetValue(currentDto)
    ).ToArray();

    // 创建新的record struct实例并替换AsyncLocal中的值
    var newDto = (PaymentMethodDto)Activator.CreateInstance(type, propertyValues);
    asyncLocalEntityDto.Value = newDto;
}

3. 可选：改为普通可写结构体

如果不需要record的不可变特性，可以将PaymentMethodDto改为普通struct，显式定义可写属性：

public struct PaymentMethodDto
{
    public int? Id { get; set; }
    public int PersonId { get; set; }
    public BenefitTypeEnum BenefitTypeId { get; set; }
    public string User { get; set; }
    public DateTime? StartDate { get; set; }
    public DateTime? EndDate { get; set; }

    public PaymentMethodDto(int? id, int personId, BenefitTypeEnum benefitTypeId, string user, DateTime? startDate, DateTime? endDate)
    {
        Id = id;
        PersonId = personId;
        BenefitTypeId = benefitTypeId;
        User = user;
        StartDate = startDate;
        EndDate = endDate;
    }
}

此时修改SetEntityProperty方法，处理值类型的副本问题：

public static void SetEntityProperty(string propertyName, object propertyValue)
{
    PropertyInfo property = typeof(PaymentMethodDto).GetProperty(propertyName);

    if (property != null && property.CanWrite)
    {
        var currentDto = asyncLocalEntityDto.Value;
        property.SetValue(currentDto, propertyValue);
        asyncLocalEntityDto.Value = currentDto; // 值类型必须重新赋值回AsyncLocal
    }
    else
    {
        throw new ArgumentException($"Property '{propertyName}' not found or is read-only in PaymentMethodDto");
    }
}

内容的提问来源于stack exchange，提问作者vladev_ops