保存复杂对象至DDB时触发DynamoDBMappingException属性转换异常

核心原因 #

异常提示Cohort[students]无法转换，本质是嵌套的Student类未被DynamoDBMapper识别为可序列化的文档类型，更深层的StudentInfo类同样缺少必要的映射注解，导致对象转换失败。

修复步骤 #

• 给Student类添加@DynamoDBDocument注解，明确告知DynamoDBMapper这是可映射的文档对象
• 给StudentInfo类也添加@DynamoDBDocument注解，确保深层嵌套属性能被正确解析
• 建议将所有public字段改为private，依赖@Data生成的getter/setter访问字段（符合Java封装规范，也能避免潜在的映射冲突）

修复后的代码 #

@DynamoDBTable(tableName = "ClassroomTable")
@Data
@NoArgsConstructor
public class Classroom {

    @DynamoDBHashKey(attributeName = "ClassID")
    private String classID;

    @DynamoDBAttribute(attributeName = "Teacher")
    private String teacher;

    @DynamoDBAttribute(attributeName = "Cohort")
    private Cohort cohort;

    @Data
    @DynamoDBDocument
    public static class Cohort {
        private ArrayList<Student> students;
    }

    @Data
    @DynamoDBDocument
    public static class Student {
        private StudentInfo studentInfo;

        @Data
        @DynamoDBDocument
        public static class StudentInfo{
            private String name;
            private Integer grade;
            private Integer age;
        } 
    }
}

额外说明 #

• @Data注解已自动生成所有字段的getter、setter等方法，无需手动编写
• 嵌套集合类型（如ArrayList<Student>）只要泛型内的类标记了@DynamoDBDocument，DynamoDBMapper就能自动处理转换
• 若问题仍存在，可检查是否有空值引发的转换异常，或升级AWS SDK至最新稳定版本

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