AWS SDK for .NET 中 DynamoDB 模型继承问题的分析与解决

问题背景

在使用 AWS SDK for .NET 操作 DynamoDB 时，开发人员遇到了一个关于模型继承的异常问题。当模型类继承自基类，并且子类中使用了 new 关键字重新定义与基类同名的属性时，调用 LoadAsync 方法会抛出 InvalidOperationException 异常，提示"Dictionary already contains item with key"。

问题复现

这个问题在以下场景中可稳定复现：

1. 定义一个基类包含公共属性
2. 创建继承类，使用 new 关键字重新定义同名属性
3. 为继承类添加 DynamoDB 相关注解
4. 尝试通过 DynamoDBContext 加载数据

典型的问题代码结构如下：

public class BaseClass
{
    public string Number { get; set; }
    public IList<string> Addresses { get; set; }
}

[DynamoDBTable("T-TableName")]
public class MyClass : BaseClass
{
    [DynamoDBHashKey]
    public new string Number
    {
        get => base.Number;
        set => base.Number = value;
    }
    public new List<string>? Addresses { get; set; }
}

技术分析

这个问题的根本原因在于 AWS SDK for .NET 在处理 DynamoDB 模型类时的属性扫描机制。在版本 3.7.300 之后，SDK 在构建属性字典时没有正确处理继承类中使用 new 关键字重定义的属性，导致同一个属性名被多次尝试添加到字典中。

具体来说，SDK 的内部处理流程如下：

1. 通过反射获取类型的所有属性
2. 将属性信息存储到字典中，以属性名为键
3. 当遇到继承类中使用 new 定义的属性时，没有正确处理属性覆盖关系
4. 尝试重复添加同名属性到字典，触发异常

影响范围

此问题影响以下版本：

• AWSSDK.DynamoDBv2 3.7.300 及以上版本
• 使用 .NET Core/.NET 5+ 的项目
• 任何使用模型继承并重定义属性的场景

解决方案

AWS SDK 团队已经发布了修复版本：

• AWSSDK.Core 3.7.304.19
• AWSSDK.DynamoDBv2 3.7.303.25

开发者只需升级到这些版本即可解决问题。

最佳实践建议

为避免类似问题，在使用 DynamoDB 数据模型时，建议：

1. 尽量避免在继承模型中使用 new 关键字重定义属性
2. 如果必须重定义属性，考虑使用不同的属性名
3. 使用接口而非继承来共享公共属性
4. 在升级 SDK 版本时，充分测试模型类的序列化/反序列化行为

总结

这个问题展示了在使用 ORM 框架时，模型继承可能带来的复杂性。AWS SDK 团队快速响应并修复了此问题，体现了对开发者体验的重视。开发者应当保持 SDK 版本的及时更新，并在设计数据模型时考虑框架的特定行为。