Spring Boot+H2数据库报错：表'THINGS_TO_DO'未找到的技术问询

嘿，我经常碰到JPA和H2搭配时的这类表映射问题，咱们一步步来搞定它。

你的报错核心很明确：SQL里要插入的THINGS_TO_DO表不存在，这大概率是实体类和数据库表的映射没对齐，或者JPA没自动帮你创建表。

一、实体类的表名配置方法 #

你的ThingsToDo.java实体类需要和数据库表名建立正确关联，有两种常用方式：

1. 用@Table注解明确指定表名 #

直接在实体类上添加@Table注解，把表名指定为你SQL里用的THINGS_TO_DO，这样JPA就会精准映射：

package me.hiboy.springboot.microserv...;

import javax.persistence.Entity;
import javax.persistence.Table;
import javax.persistence.Id;

@Entity // 必须加这个注解，告诉JPA这是实体类
@Table(name = "THINGS_TO_DO") // 这里指定表名，和你INSERT语句里的完全一致
public class ThingsToDo {
    @Id // 主键注解不能少
    private Long id;
    private String name;
    private Boolean verified;

    // 记得加上无参构造、getter和setter，JPA需要这些
}

如果不加@Table，JPA默认会把驼峰式的类名转成下划线分隔的小写（比如ThingsToDo会变成things_to_do），而你的SQL用的是大写的THINGS_TO_DO，H2默认区分大小写，自然就找不到了。

2. 配置JPA自动创建表 #

光有实体类还不够，得让Spring Boot帮你自动生成表。在application.properties或者application.yml里加上这些配置：

application.properties版本：

# H2基础配置
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

# JPA自动建表关键配置
spring.jpa.hibernate.ddl-auto=update # 推荐用update，启动时自动创建/更新表结构
spring.jpa.show-sql=true # 可以看到生成的SQL语句，方便排查
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.H2Dialect

application.yml版本：

spring:
  datasource:
    url: jdbc:h2:mem:testdb
    driver-class-name: org.h2.Driver
    username: sa
    password:
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true
    properties:
      hibernate:
        dialect: org.hibernate.dialect.H2Dialect

这里解释下spring.jpa.hibernate.ddl-auto的可选值：

• create：每次启动都删旧表建新表，适合测试环境
• create-drop：启动建表，关闭应用时删表，临时测试用
• update：表不存在就创建，存在就更新结构，开发常用
• validate：只验证表结构和实体类是否匹配，不创建/修改表

二、H2数据库表名的注意事项 #

1. 大小写敏感问题：H2在内存模式下默认区分大小写，如果不想纠结大小写，可以在数据库URL里加;IGNORECASE=TRUE，比如：

spring.datasource.url=jdbc:h2:mem:testdb;IGNORECASE=TRUE

这样不管你用大写还是小写的表名，H2都会识别。

2. 命名规则：表名尽量用下划线分隔（比如things_to_do），避免用SQL关键字（比如USER、ORDER，如果非要用，得用双引号包裹，比如"ORDER"），也别加特殊字符。

三、快速排查小技巧 #

• 打开H2控制台：启动应用后，访问http://localhost:8080/h2-console（默认路径），登录后看看有没有THINGS_TO_DO表，结构对不对。
• 看控制台SQL：开启spring.jpa.show-sql=true后，启动应用时会看到Hibernate生成的建表SQL，确认表名是不是你要的。
• 检查实体类注解：确保@Entity和@Id注解都加了，少了的话JPA不会把它当成实体类来生成表。

内容的提问来源于stack exchange，提问作者P.K.