Spring Boot中如何通过SQL文件为H2的UUID主键填充可被JPA查询的测试数据

你遇到的findById查询不到已插入数据的问题，是两个常见配置和格式问题叠加导致的：

• Spring Boot 2.4 之后默认的初始化执行顺序、Hibernate与H2的UUID类型映射逻辑不兼容，导致SQL写入的UUID值和JPA查询时的类型转换结果不匹配
• 你写入的ID字符串不符合Java UUID的标准格式，即使数据插入成功，实际存储的值和查询时传入的UUID解析结果存在差异

1. 调整测试环境配置 #

在测试用的配置文件（如application-test.properties）中添加以下配置，解决两个核心兼容问题：

# 等JPA完成表结构创建后，再执行data.sql导入数据，避免表结构不匹配
spring.jpa.defer-datasource-initialization=true
# 统一Hibernate对UUID类型的处理逻辑，和H2数据库的UUID存储规则对齐
spring.jpa.properties.hibernate.type.uuid.implicit_natural_representation=uuid

2. 修正实体类的UUID字段映射 #

在实体类的主键字段上显式指定列定义，避免Hibernate默认的模糊映射导致的类型偏移：

@Entity(name="TEST_TABLE")
public class TestTable {
    @Id
    @GeneratedValue
    // 显式指定列类型为uuid，和H2的存储类型对齐
    @Column(columnDefinition = "uuid")
    private UUID id;
    
    // 其他业务字段省略
}

如果需要跨数据库兼容，也可以把列定义改成varchar(36)，统一存储带连字符的UUID字符串，这种方式在H2、MySQL、PostgreSQL上都能正常工作。

3. 编写合规的data.sql导入语句 #

• 首先要保证写入的UUID是符合Java UUID规范的标准格式（共36个字符，包含4个连接符，结构为8-4-4-4-12的十六进制串），你之前写的无连接符的长串本身就不是合规的UUID，无法被Java正确解析
• 修正SQL语法，单条插入的关键字用VALUES，避免版本兼容问题

修正后的data.sql示例：

INSERT INTO TEST_TABLE(id, name, pass) 
VALUES ('2b122455-6658-4788-8779-679a1b2c3d4e', 'test', 'xxxxx');

4. 测试调用的注意事项 #

调用findById时，要直接传入正确解析的UUID类型对象，不要手动拼错格式：

// 正确：通过UUID的静态方法解析标准格式字符串生成查询参数
UUID testQueryId = UUID.fromString("2b122455-6658-4788-8779-679a1b2c3d4e");
Optional<TestTable> queryResult = testTableRepository.findById(testQueryId);

• 不要用去掉连接符的字符串存UUID：比如Java的UUID在二进制映射模式下，会把去掉连接符的32位十六进制串转成16字节的二进制值存储，如果你用varchar列直接存这个32位字符串，即使字符内容完全一致，也会因为类型不匹配导致查询无法命中
• 不要颠倒初始化顺序：Spring Boot 2.4之前默认是先执行data.sql再让JPA建表，2.4之后调整了执行顺序，如果不手动配置defer-datasource-initialization=true，会出现JPA建表时把data.sql导入的数据清空的问题

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