Spring Boot JPA启动时数据打印却未插入H2数据库，API无法调用求助

一、数据未写入H2数据库的问题 #

1. 检查事务配置与提交情况 #

• 若使用Spring Batch，需确保Job/Step的事务配置正确。默认Spring Batch会管理事务，但如果在JobCompletionNotificationListener中手动操作EntityManager，要保证操作处于事务范围内：
  • 在listener的方法上添加@Transactional注解（需确保该类被Spring管理，比如加了@Component）。
  • 避免手动调用em.flush()和em.commit()，优先依赖Spring的事务自动管理。
• 检查application.properties中JPA配置：确保spring.jpa.hibernate.ddl-auto设置为create或update，若为none会导致表未创建，插入操作自然失效。

2. 确认H2数据库的持久化配置 #

• 检查H2的JDBC URL：
  • 需持久化数据时，改用文件模式URL：jdbc:h2:file:./data/testdb；若用内存模式，必须添加DB_CLOSE_DELAY=-1和DB_CLOSE_ON_EXIT=FALSE，防止连接关闭后数据丢失，示例：

    spring.datasource.url=jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE
    

• 确保H2控制台连接的URL与应用配置一致，避免因连接不同实例导致看不到数据。

3. 验证实体类映射正确性 #

• 确保Sample实体类添加@Entity注解，主键字段添加@Id注解，示例：

  @Entity
  public class Sample {
      @Id
      @GeneratedValue(strategy = GenerationType.IDENTITY)
      private Long id;
      private String name;
      // getter/setter
  }
  

• 检查字段映射：若用@Column指定列名，需确保与数据库列名匹配，避免因列名不匹配导致插入失败。

二、API接口无法正常工作的问题 #

1. 检查控制器的配置 #

• 确保控制器类添加@RestController（或@Controller+@ResponseBody）注解，且@RequestMapping路径配置正确。
• 确认Spring Boot组件扫描范围覆盖控制器所在包：默认扫描启动类所在包及其子包，若控制器在其他包，需在启动类添加@ComponentScan(basePackages = "com.your.package")。

2. 排查接口业务逻辑 #

• 若接口查询数据库数据，先通过H2控制台确认数据库中是否存在数据，数据未写入会导致接口返回空或错误。
• 检查接口是否存在未捕获的异常：可在控制器添加@ExceptionHandler做全局异常处理，或查看控制台错误日志定位问题。

三、em.contains(sampleD)判断失效的问题 #

1. 确认实体处于持久化上下文 #

• EntityManager.contains()仅对托管状态的实体返回true：如果sampleD是new出来的对象，或已被detach（比如事务提交后），都会返回false。需先调用em.persist(sampleD)将实体加入持久化上下文，再调用contains才会生效。

2. 检查主键状态 #

• 若实体使用主键生成策略（如@GeneratedValue），调用persist前主键值为null，此时contains无法识别实体（持久化上下文通过主键跟踪实体）。需在persist执行、主键生成后再调用contains。

3. 确保在同一事务内调用 #

• 若contains的调用与插入操作不在同一事务中，事务提交后实体变为detached状态，contains会返回false。需将相关操作放在同一个事务方法内。

额外排查步骤 #

• 开启JPA SQL日志，查看是否有插入语句执行：

  spring.jpa.show-sql=true
  spring.jpa.properties.hibernate.format_sql=true
  

  若控制台无插入SQL，说明代码未触发插入；若有SQL但无报错，检查事务是否提交或H2配置是否正确。
• 查看Spring Boot启动日志，检查实体类扫描、事务配置、数据库连接的错误信息（如表创建失败、事务管理器未找到等）。

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