将JPA实体类@Table注解改为"users"时H2数据库报错问题排查

核心原因 #

H2数据库内置了INFORMATION_SCHEMA.USERS系统视图，当你使用未加引号的USERS作为表名时，H2会优先将其解析为这个系统视图，而非你通过JPA创建的业务表。这就导致执行ALTER TABLE USERS ADD CONSTRAINT语句时，H2找不到你实际需要操作的业务表，抛出表不存在的错误。

原表名user能正常运行，是因为user属于H2的保留关键字，多数JPA实现（如Hibernate）会自动对保留关键字添加引号转义，从而创建出正确的自定义表。而users并非H2的保留关键字，JPA不会自动转义，才会和系统视图产生冲突。其他表名没问题，是因为它们没有和H2的系统视图或关键字重名。

解决方法 #

1. 显式添加引号转义表名
   在实体类的@Table注解中，用双引号包裹表名，强制H2识别为自定义表：

   @Table(name = "\"users\"")
   

2. 修改H2连接配置调整标识符规则
   在H2的JDBC连接URL中添加参数，让H2对标识符不区分大小写或统一转为小写，避免与系统视图冲突：

   jdbc:h2:mem:testdb;DATABASE_TO_LOWER=TRUE;DB_CLOSE_DELAY=-1
   

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