DynamoDBMapper存Java Date为String引发Scan时间转换报错

• DynamoDB 无原生日期类型支持，DynamoDBMapper 对 java.util.Date 的默认映射逻辑为：序列化阶段将Date值转换为ISO8601格式字符串存储，反序列化阶段按照固定格式解析存储的字符串。
• 出现扫描时报错 time cannot be unconverted 的核心原因包含两类：
  1. 写入/读取的转换逻辑不对齐：写入时序列化生成的字符串格式，和读取阶段反序列化的预期格式不匹配，常见场景包括历史存量数据格式混乱、时区转换错位、写入时未走默认序列化逻辑导致存储值格式异常。
  2. 代码笔误：示例代码中addData方法内传入mapper.save()的参数写为类名MyClass，实际需要传入已实例化的对象myClass，否则会写入不符合预期的空对象，进一步导致存储的create_time字段值格式异常。

1. 对齐默认映射格式完成存量数据清洗 #

排查表内所有create_time字段的存储值，确保所有值完全符合 DynamoDBMapper 默认解析的UTC ISO8601格式（格式为yyyy-MM-dd'T'HH:mm:ss.SSS'Z'）。针对格式不统一的存量值，批量修正为可识别的标准格式后，即可正常完成扫描反序列化。

2. 自定义字段级类型转换器（推荐） #

通过自定义类型转换器统一读写转换逻辑，从根源避免格式错位问题，实现步骤：

• 实现DynamoDBTypeConverter接口，根据自身存储需求定义Date和DynamoDB支持的原生类型（String、Number）的双向转换规则，例如统一存储毫秒时间戳的示例代码：

  public class DateToLongConverter implements DynamoDBTypeConverter<Long, Date> {
      @Override
      public Date unconvert(Long timestamp) {
          return new Date(timestamp);
      }
  
      @Override
      public Long convert(Date date) {
          return date.getTime();
      }
  }
  

• 在实体类的Date字段上绑定自定义转换器，替换默认映射逻辑：

  @DynamoDBAttribute(attributeName = "create_time")
  @DynamoDBTypeConverted(converter = DateToLongConverter.class)
  public Date createTime;
  

• 注意：绑定自定义转换器后，需要同步清洗存量create_time字段值，和新的转换逻辑保持一致，避免再次触发转换错误。

3. 全局配置统一时间映射规则 #

如果项目内存在大量Date类型字段，可在初始化DynamoDBMapper时配置全局统一的时间序列化规则，替代默认逻辑，示例代码：

DynamoDBMapperConfig mapperConfig = new DynamoDBMapperConfig.Builder()
    .withObjectMapperFactory(() -> {
        ObjectMapper globalMapper = new ObjectMapper();
        // 自定义和存储值完全匹配的时间格式
        SimpleDateFormat customFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        globalMapper.setDateFormat(customFormat);
        return globalMapper;
    })
    .build();
// 初始化Mapper时传入自定义配置
DynamoDBMapper mapper = new DynamoDBMapper(dynamoDBClient, mapperConfig);

注意：全局配置修改后，所有实体类的Date字段映射都会受影响，必须确保配置的解析格式和历史存储值完全对齐，否则会扩大转换报错的覆盖范围。

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