如何处理DynamoDB同一字段S/N混合数据类型的映射兼容问题

针对createdAt字段同时存在S、N两种类型的映射问题，不需要修改存量数据即可实现兼容，以下是两种生产可用的实现方案：

• 方案1：自定义类型转换器（推荐）
  利用DynamoDBMapper提供的DynamoDBTypeConverter扩展点，在转换层自动识别读取到的字段类型，统一映射为Java Long类型，写入时固定输出单一类型，逐步清洗存量数据。
  首先实现自定义转换器：

import com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBTypeConverter;
import com.amazonaws.services.dynamodbv2.model.AttributeValue;

public class CreatedAtConverter implements DynamoDBTypeConverter<AttributeValue, Long> {
    @Override
    public AttributeValue convert(Long value) {
        // 新写入数据统一存为Number类型，逐步统一存量格式
        return new AttributeValue().withN(String.valueOf(value));
    }

    @Override
    public Long unconvert(AttributeValue dbValue) {
        // 读取时自动兼容两种类型
        if (dbValue.getN() != null) {
            return Long.parseLong(dbValue.getN());
        }
        if (dbValue.getS() != null) {
            return Long.parseLong(dbValue.getS().trim());
        }
        // 字段为空时返回null，可根据业务需要调整默认值
        return null;
    }
}

实体类中替换原有的@DynamoDBTyped注解，指定使用自定义转换器即可：

@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@ToString
@EqualsAndHashCode
@DynamoDBTable(tableName = "SomeTable")
public class SomeTable {
    @DynamoDBAttribute
    @DynamoDBTypeConverted(converter = CreatedAtConverter.class)
    private Long createdAt;
}

该方案对业务代码完全透明，没有额外侵入，新写入的数据会自动统一为Number类型，存量数据随着业务更新会逐步被覆盖，长期运行后可移除兼容逻辑，完全收敛为单一类型。

• 方案2：原始属性手动转换（快速适配）
  如果不想额外编写转换器类，可以直接用DynamoDB原生AttributeValue类型接收字段值，在实体类内部做类型转换，对外只暴露业务需要的Long类型字段：

@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@ToString
@EqualsAndHashCode
@DynamoDBTable(tableName = "SomeTable")
public class SomeTable {
    // 接收原始字段值，不限制类型
    @DynamoDBAttribute(attributeName = "createdAt")
    private AttributeValue createdAtRaw;

    // 业务层使用的字段，不参与DynamoDB映射
    @DynamoDBIgnore
    public Long getCreatedAt() {
        if (createdAtRaw == null) return null;
        if (createdAtRaw.getN() != null) return Long.parseLong(createdAtRaw.getN());
        if (createdAtRaw.getS() != null) return Long.parseLong(createdAtRaw.getS().trim());
        return null;
    }

    // 写入时统一赋值为Number类型
    public void setCreatedAt(Long createdAt) {
        this.createdAtRaw = new AttributeValue().withN(String.valueOf(createdAt));
    }
}

该方案实现简单，适合临时快速适配场景，缺点是实体类会冗余原始字段，长期维护成本略高于自定义转换器方案。

注意：无论使用哪种方案，写入时都建议固定为Number类型存储时间戳，避免后续新增其他类型数据导致兼容逻辑越来越复杂。

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