在互联网大厂后端开发领域，技术的更迭日新月异。Spring Boot 作为当下极为流行的开发框架，其默认数据源 H2 的整合配置对于后端开发人员而言至关重要。掌握好这一关键技术点，能够极大地提升开发效率与系统性能。今天，咱们就来深入探讨一下 Spring Boot 默认数据源 H2 的详细整合配置流程。

创建 Spring Boot 项目

创建 Spring Boot 项目是一切的开端，我们可以借助 Spring Initializr 这个便捷工具快速完成。在创建时，有几个关键设置需要注意：

1. Spring Boot 版本选择：尽量挑选最新版本，以获取最新的功能特性和性能优化。例如当下，最新版本可能修复了过往版本的一些安全漏洞，并且在对新特性的支持上更胜一筹。
2. 依赖添加：对于我们要整合 H2 数据源，需要添加 Spring Web、Spring Data JPA 以及 H2 Database 依赖。Spring Web 能帮助我们构建 Web 应用程序，处理 HTTP 请求；Spring Data JPA 简化了数据库访问层的开发；H2 Database 依赖则是我们使用 H2 数据库的基础。

当完成上述设置后，生成项目并下载解压缩，就得到了一个基础的 Spring Boot 项目框架。

添加 H2 数据库依赖

在解压缩后的项目中，找到pom.xml文件，这是项目的依赖管理文件。若在创建项目时已正确选择 H2 Database 依赖，那么该文件中应已包含如下代码：

<groupId>com.h2database</groupId>
<artifactId>h2</artifactId>

这段代码就是引入 H2 数据库依赖的关键，它告诉 Maven（项目构建工具），我们的项目需要使用 H2 数据库相关的库。如果在创建项目时遗漏了该依赖，也可手动将这段代码添加到pom.xml的<dependencies>标签内，然后 Maven 会自动下载相关的依赖包到本地仓库，供项目使用。

配置 H2 数据库

配置 H2 数据库是整个流程的核心部分，这一步需要在
src/main/resources/application.properties文件（如果项目使用 YAML 配置，对应为application.yml文件）中进行一系列设置。

基本配置

数据库连接地址：添加spring.datasource.url=jdbc:h2:mem:testdb，这里配置的是使用内存数据库，数据库名称为testdb。内存数据库的优势在于其读写速度极快，对于开发和测试环境而言，能显著提升效率。当然，若有需要，也可配置为文件存储等其他方式，例如spring.datasource.url=jdbc:h2:file:~/testdb，表示将数据库存储在用户主目录下的testdb文件中。

数据库驱动类：设置
spring.datasource.driverClassName=org.h2.Driver，这指定了使用 H2 数据库的驱动类，Spring Boot 需要通过这个驱动类来与 H2 数据库建立连接。

用户名和密码：默认情况下，H2 数据库的用户名一般为sa，密码为空，所以可以添加
spring.datasource.username=sa、
spring.datasource.password=。但在实际生产环境中，出于安全考虑，强烈建议修改为强密码。例如
spring.datasource.password=YourStrongPassword123。

对应的 YAML 配置格式如下：

spring:
  datasource:
    url: jdbc:h2:mem:mydb
    driver-class-name: org.h2.Driver
    username: sa
    password: password

这里将数据库连接地址设置为jdbc:h2:mem:mydb，可根据实际需求修改。

其他可选配置

初始化数据库：如果希望在项目启动时自动初始化数据库，可以在src/main/resources目录下添加data.sql文件。在这个文件中，可以编写 SQL 语句来创建表、插入初始数据等。例如：

CREATE TABLE users (id INT PRIMARY KEY, name VARCHAR(50), email VARCHAR(100));
INSERT INTO users (id, name, email) VALUES (1, 'John Doe', 'john@example.com');

Spring Boot 在启动时会自动读取并执行data.sql中的 SQL 语句，从而完成数据库的初始化。若不想使用这种默认的初始化方式，可以通过设置spring.sql.init.mode=never来禁用。另外，如果使用了如 Flyway 或 Liquibase 等数据库迁移工具，并且希望在它们之后再执行data.sql中的初始化操作，可以设置
spring.jpa.defer-datasource-initialization=true。

启用 H2 控制台：H2 数据库自带一个控制台，方便我们在开发过程中直接查看和操作数据库。要启用它，在application.properties中添加spring.h2.console.enabled=true。同时，还可以指定控制台的访问路径，例如spring.h2.console.path=/h2-console，这样我们就可以通过
http://localhost:8080/h2-console（假设项目运行在 8080 端口）来访问 H2 控制台。对应的 YAML 配置为：

spring:
  h2:
    console:
      enabled: true
      path: /h2-console

创建实体类和 Repository（若使用 JPA）

如果在项目中使用 JPA（Java Persistence API）作为持久层框架，那么还需要创建实体类和 Repository。

创建实体类

以创建一个简单的User实体类为例，代码如下：

package com.example.demo.model;

import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;

    // 省略getter和setter方法
}

在这个实体类中，使用了@Entity注解标记这是一个 JPA 实体类，@Id注解标识id字段为主键，@GeneratedValue注解指定主键的生成策略为自增长。通过这种方式，JPA 能够将 Java 对象与数据库表进行映射，方便进行数据的持久化操作。

创建 Repository 接口

创建一个UserRepository接口，继承JpaRepository，代码如下

package com.example.demo.repository;

import com.example.demo.model.User;
import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
}

通过继承JpaRepository，UserRepository接口自动拥有了对User实体类的基本 CRUD（创建、读取、更新、删除）操作方法，例如save方法用于保存实体，findById方法用于根据主键查找实体等。这大大减少了我们编写数据库访问代码的工作量。

创建控制器和服务

根据项目的实际业务需求，可能需要创建控制器和服务层来处理业务逻辑和对外提供接口。

创建服务层类

创建一个UserService类，代码如下：

package com.example.demo.service;

import com.example.demo.model.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserService {
    @Autowired
    private UserRepository userRepository;

    public List<User> getAllUsers() {
        return userRepository.findAll();
    }

    public User saveUser(User user) {
        return userRepository.save(user);
    }
}

在这个服务层类中，通过@Autowired注解注入了UserRepository，然后定义了getAllUsers和saveUser方法，分别用于获取所有用户和保存用户，这些方法内部调用了UserRepository的相应方法来实现对数据库的操作。

创建控制器类

创建一个UserController类，代码如下：

package com.example.demo.controller;

import com.example.demo.model.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping
    public ResponseEntity<List<User>> getAllUsers() {
        List<User> users = userService.getAllUsers();
        return new ResponseEntity<>(users, HttpStatus.OK);
    }

    @PostMapping
    public ResponseEntity<User> createUser(@RequestBody User user) {
        User savedUser = userService.saveUser(user);
        return new ResponseEntity<>(savedUser, HttpStatus.CREATED);
    }
}

在控制器类中，使用@RestController注解标记这是一个 RESTful 风格的控制器，@RequestMapping("/users")注解指定了该控制器处理的请求路径为/users。@GetMapping和@PostMapping注解分别处理 HTTP GET 和 POST 请求，通过调用UserService的方法来处理业务逻辑，并返回相应的 HTTP 响应。

启动应用并测试

完成上述所有配置和代码编写后，就可以启动 Spring Boot 应用进行测试了。运行项目的主启动类（通常是带有@SpringBootApplication注解的类），如果项目配置正确，应用将成功启动。

测试 H2 控制台

如果之前启用了 H2 控制台，可以通过配置的路径（如
http://localhost:8080/h2-console）访问控制台。使用在application.properties中配置的用户名和密码登录后，在控制台中可以看到创建的数据库表，例如users表。可以在控制台中执行 SQL 查询，如SELECT * FROM users，来验证数据是否正确存储。

测试控制器接口

如果创建了控制器和服务，可以通过发送 HTTP 请求来测试接口。例如，使用 Postman 等工具，发送 GET 请求到
http://localhost:8080/users，应该能够获取到之前保存的用户列表；发送 POST 请求到
http://localhost:8080/users，并在请求体中传入一个User对象的 JSON 数据，如{"name":"Jane Doe","email":"jane@example.com"}，应该能够成功创建一个新用户，并返回创建后的用户信息。

总结

通过以上详细的步骤，我们就完成了 Spring Boot 与默认数据源 H2 的整合配置。在实际的互联网大厂后端开发中，熟练掌握这一技术，无论是在开发新功能还是优化现有系统时，都能让我们更加得心应手，提升开发效率和系统性能。希望本文能对各位互联网大厂后端开发人员有所帮助，大家在实践中不妨多多尝试，深入理解其中的原理和细节。

Tags：h2 database