SpringBoot（STS4）连接H2数据库失败报错求助

一、先解决data.sql语法错误导致的启动失败 #

启动失败是核心问题，必须先修复这个才能继续排查其他问题：

• 匹配H2语法规则：H2默认使用自身语法，若你的data.sql是MySQL/Oracle风格，需调整或开启兼容模式：
  • 比如MySQL的AUTO_INCREMENT替换为H2的IDENTITY；
  • 或在application.properties中添加兼容配置：spring.datasource.url=jdbc:h2:mem:testdb;MODE=MySQL（按需替换为对应数据库模式）。
• 检查脚本细节：核对表名/字段名拼写、数据类型匹配、语句结尾分号、字符串单引号包裹等，比如避免INSERT INTO user (name) VALUES ("张三");这种双引号错误，改为单引号'张三'。
• 查看启动日志定位错误：SpringBoot启动日志会明确输出语法错误的行号和原因，直接定位对应行修正即可。

二、修复H2控制台无法访问的问题 #

启动成功后仍无法访问控制台，按以下步骤排查：

• 确认控制台配置正确：确保application.properties包含以下配置：

  spring.h2.console.enabled=true
  spring.h2.console.path=/h2-console
  spring.datasource.url=jdbc:h2:mem:testdb
  spring.datasource.driverClassName=org.h2.Driver
  spring.datasource.username=sa
  spring.datasource.password=
  spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
  

• 检查应用实际端口：若8080端口被占用，应用会自动切换端口，查看启动日志中Tomcat started on port(s): XXXX (http)的信息，访问http://localhost:XXXX/h2-console。
• 处理Spring Security拦截：若项目引入Spring Security，需放行H2控制台路径，添加配置类：

  @Configuration
  @EnableWebSecurity
  public class SecurityConfig extends WebSecurityConfigurerAdapter {
      @Override
      protected void configure(HttpSecurity http) throws Exception {
          http.csrf().disable()
              .headers().frameOptions().disable()
              .and()
              .authorizeRequests()
              .antMatchers("/h2-console/**").permitAll();
      }
  }
  

• 清除浏览器缓存：用隐身模式打开控制台页面，避免缓存导致的访问异常。

三、验证数据插入与连接 #

• 启动应用后，访问H2控制台，输入配置中的JDBC URL、用户名sa、空密码，点击「连接」。
• 执行SELECT * FROM 你的表名;检查data.sql是否成功插入数据。
• 若数据未插入，添加配置spring.sql.init.mode=always（SpringBoot 2.5+版本），确保初始化脚本强制执行。

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