Spring Boot+H2数据库连接遇表不存在问题，求助排查解决

嘿，刚上手第一个Spring Boot应用就碰到数据库连接问题？太正常了，我帮你一步步捋清楚怎么排查和解决！

1. 先确认pom.xml的依赖是否齐全 #

你用的是Maven 4.0.0，首先得确保Spring Boot JDBC starter和H2数据库的依赖都正确引入——这俩是核心，少一个都不行。如果你的pom.xml里还没加全，补一下这些配置：

<!-- 一定要加Spring Boot的parent依赖，它会帮你自动管理所有依赖的版本 -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.0</version> <!-- 用最新稳定版即可，版本不匹配也可能引发问题 -->
    <relativePath/>
</parent>

<!-- Spring Boot JDBC Starter，包含JdbcTemplate和默认连接池 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>

<!-- H2数据库依赖，runtime scope表示仅在运行时生效 -->
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>

2. 检查application.properties的配置是否正确 #

你已经在resources下创建了这个配置文件，那得确保里面的参数没写错。给你一个标准的H2配置模板，分两种常用模式：

内存模式（数据重启即丢失，适合快速测试） #

# H2数据库连接地址
spring.datasource.url=jdbc:h2:mem:testdb
# H2驱动类（Spring Boot 2.x/3.x通用）
spring.datasource.driverClassName=org.h2.Driver
# 默认用户名和密码
spring.datasource.username=sa
spring.datasource.password=

# 开启H2控制台，方便直接查看数据库内容
spring.h2.console.enabled=true
# 控制台访问路径，启动应用后访问http://localhost:8080/h2-console
spring.h2.console.path=/h2-console

文件模式（数据持久化到本地，适合需要保留数据的场景） #

只需把连接地址改成下面这样：

spring.datasource.url=jdbc:h2:file:./data/testdb

3. 确认JdbcTemplate的注入方式正确 #

Spring Boot会自动帮你创建JdbcTemplate实例，只要依赖和配置没问题，直接注入就行。推荐用构造函数注入（比@Autowired更安全，也是Spring官方推荐的方式），示例代码如下：

import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    private final JdbcTemplate jdbcTemplate;

    // 构造函数注入，Spring会自动传入JdbcTemplate实例
    public UserService(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }

    // 示例查询方法，测试数据库连接是否正常
    public String getUserNameById(Long id) {
        String sql = "SELECT name FROM users WHERE id = ?";
        return jdbcTemplate.queryForObject(sql, new Object[]{id}, String.class);
    }
}

4. 常见问题排查小技巧 #

• H2控制台打不开：先检查spring.h2.console.enabled是否设为true，启动应用后访问http://localhost:8080/h2-console，控制台里的JDBC URL要和配置文件里的spring.datasource.url完全一致。
• 报“表不存在”错误：如果是内存模式，每次重启应用数据库都会清空。可以在resources下创建schema.sql（建表语句）和data.sql（初始化数据），Spring Boot启动时会自动执行这两个文件：

  -- schema.sql
  CREATE TABLE IF NOT EXISTS users (
      id BIGINT AUTO_INCREMENT PRIMARY KEY,
      name VARCHAR(50) NOT NULL,
      email VARCHAR(100) UNIQUE NOT NULL
  );
  
  -- data.sql
  INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com');
  

• 连接超时或失败：检查URL有没有拼写错误（比如内存模式的URL是jdbc:h2:mem:testdb，别少了冒号），用户名密码是否和配置一致。

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