未安装H2时如何在IntelliJ中使用h2-console及报错解决

一、未安装H2客户端时使用h2-console #

你不需要单独安装H2客户端，通过Spring Boot的依赖就能内置H2服务，步骤如下：

• 给项目添加H2 runtime依赖：
  Maven项目（pom.xml）：

  <dependency>
      <groupId>com.h2database</groupId>
      <artifactId>h2</artifactId>
      <scope>runtime</scope>
  </dependency>
  

  Gradle项目（build.gradle）：

  runtimeOnly 'com.h2database:h2'
  

• 在application.properties（或application.yml）中配置H2控制台和数据源：

  # 开启H2控制台
  spring.h2.console.enabled=true
  # 内存式H2数据库连接地址
  spring.datasource.url=jdbc:h2:mem:testdb
  spring.datasource.driverClassName=org.h2.Driver
  spring.datasource.username=sa
  spring.datasource.password=
  

  启动Spring Boot应用后，直接访问localhost:8080/h2-console，输入上面的jdbc:h2:mem:testdb作为JDBC URL，就能正常操作H2数据库了，全程不需要本地安装H2客户端。

二、解决INSERT INTO USER的语法错误 #

USER是H2的保留关键字，直接使用会触发语法错误，两种解决方式：

1. 给表名加转义符
   修改SQL语句，用反引号包裹表名：

   INSERT INTO `USER` VALUES(1, 'testuser')
   

   如果是用JPA定义实体类，在@Table注解里指定转义后的表名：

   @Table(name = "`USER`")
   public class User {
       // 实体字段
   }
   

2. 修改H2 SQL模式，排除USER作为关键字
   在数据源URL中添加;NON_KEYWORDS=USER，修改application.properties：

   spring.datasource.url=jdbc:h2:mem:testdb;NON_KEYWORDS=USER
   

   这样H2就不会把USER识别为关键字，原SQL语句可以直接执行。

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