Java8+Spring+Lombok项目中@ElementCollection相关序列化问题

我帮你梳理下这个序列化问题的排查方向和解决方案，结合你贴的Operation类代码，大概率是这几个地方踩坑了：

1. 检查Lombok注解的完整性 #

你的Operation类里，id字段加了@Getter和@Setter，但name字段只有@NonNull和@NotEmpty，没有对应的访问注解；那个List<Period>字段代码也没写完，大概率也没加@Getter。Spring常用的序列化框架（比如Jackson）默认依赖getter方法读取字段值，如果缺少这些方法，就会抛出序列化异常。

解决办法：

• 给name字段补上@Getter @Setter（如果只需要序列化不需要反序列化，可只加@Getter）；
• 给List<Period>字段补全@Getter（如果需要对外暴露或序列化）；
• 或者全局配置Jackson允许直接访问字段，在配置类中添加：

@Bean
public ObjectMapper objectMapper() {
    ObjectMapper mapper = new ObjectMapper();
    mapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
    return mapper;
}

2. 校验Period类的序列化与JPA注解合规性 #

你用了@ElementCollection(targetClass = Period.class)，这里有两个关键要求：

• Period必须是JPA的@Embeddable类（否则JPA映射会失败，间接引发序列化异常）；
• 序列化时Period必须实现java.io.Serializable接口（Spring缓存、远程调用或JSON序列化场景下，自定义类型不实现Serializable必然报错）。

解决办法：

@Embeddable
@Data
public class Period implements Serializable {
    // 你的字段与业务注解
    private static final long serialVersionUID = 1L; // 建议显式声明序列化ID，避免序列化版本冲突
}

3. 处理JPA注解与序列化框架的冲突 #

你给id字段加了@Access(AccessType.PROPERTY)，这个注解是告诉JPA通过getter/setter访问id，但Jackson默认会同时扫描字段和getter方法，可能导致id被重复序列化，或因访问权限问题抛出异常。

解决办法：

• 若想统一用属性访问（getter/setter），给Operation类加上@JsonAutoDetect(getterVisibility = JsonAutoDetect.Visibility.ANY, fieldVisibility = JsonAutoDetect.Visibility.NONE)，让Jackson只通过getter读取字段；
• 或者在id字段上添加@JsonIgnore，仅通过getter序列化id，避免冲突。

4. 调试定位具体异常 #

如果以上方法没解决问题，建议写个简单测试用例，直接用Jackson序列化Operation对象，查看具体报错栈：

@Autowired
private ObjectMapper objectMapper;

@Test
public void testOperationSerialization() throws JsonProcessingException {
    Operation testOp = new Operation();
    testOp.setName("测试操作");
    // 给Period列表添加测试数据
    testOp.setPeriods(Arrays.asList(new Period(...)));
    
    String jsonResult = objectMapper.writeValueAsString(testOp);
    System.out.println(jsonResult);
}

报错信息会明确指出是哪个字段、哪个类出了问题（比如"no getter for field 'name'"或"Period not serializable"），帮你精准修复。

内容的提问来源于stack exchange，提问作者Thiago de Souza