Spring Data Jpa Repository调用save后实体未保存到数据库问题

故障原因排查及解决方案 #

1. 实体类注解配置缺失 #

你当前贴出的NewClientFormWrapper只是参数包装类，需确认三个关联的业务实体NaturalPerson、Address、CommunicationChannel都满足JPA规范：

• 类上添加@Entity注解
• 主键字段添加@Id注解，同时配置主键生成策略，例如@GeneratedValue(strategy = GenerationType.IDENTITY)
  缺少以上注解时，JPA不会将类识别为持久化实体，执行save操作不会触发SQL写入，也不会抛出异常。

2. 关联关系级联保存配置缺失 #

NaturalPerson类中关联Address、CommunicationChannel的字段（一般是@OneToMany注解修饰的集合字段），需要添加级联保存配置：

@OneToMany(cascade = CascadeType.ALL, mappedBy = "naturalPerson")
private List<Address> addresses;

@OneToMany(cascade = CascadeType.ALL, mappedBy = "naturalPerson")
private List<CommunicationChannel> communicationChannels;

如果没有配置cascade = CascadeType.PERSIST/CascadeType.ALL，保存主实体NaturalPerson时不会自动保存关联的瞬时态子实体，导致整个事务静默回滚，不会写入数据。

3. 事务配置不生效 #

你将@Transactional注解加在了Controller层方法上，需要确认项目启动类/配置类已添加@EnableTransactionManagement注解开启事务管理，否则事务不会生效，save操作不会提交到数据库。
另外Spring默认事务只对RuntimeException回滚，若业务代码抛出非运行时异常且没有配置回滚规则，也会出现数据不写入的情况。

4. H2内存数据库查询路径不匹配 #

你使用的是H2内存数据库，内存库的生命周期和连接绑定，如果你通过H2控制台查询数据，需确保控制台填写的连接URL和配置文件中的spring.datasource.url完全一致：jdbc:h2:mem:party;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE;MODE=MYSQL，如果填错路径会连接到其他独立的内存库，自然查询不到写入的数据。

5. 主键策略异常 #

如果NaturalPerson的主键字段没有配置生成策略，且你没有手动赋值主键，save操作会尝试写入主键为null的记录，部分数据库兼容模式下不会抛出异常，但实际不会写入成功。

快速验证方式 #

你配置中已经开启了Hibernate SQL日志：logging.level.org.hibernate.SQL=DEBUG，调用接口后查看控制台是否打印了INSERT语句：如果没有打印说明实体没有被识别为持久化对象，优先排查前两个原因；如果打印了INSERT语句但查不到数据，优先排查事务和H2连接问题。

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