
DB Rider 不支持直接在 YAML 中以十六进制(如 \x4c6f...)或原始字节形式定义 byte[] 字段,必须使用 Base64 编码字符串;Spring JDBC 读取时会自动解码为 byte[],与 rs.getBytes() 兼容。
db rider 不支持直接在 yaml 中以十六进制(如 \x4c6f...)或原始字节形式定义 byte[] 字段,必须使用 base64 编码字符串;spring jdbc 读取时会自动解码为 byte[],与 rs.getbytes() 兼容。
在基于 Database Rider + Spring JDBC + H2 的测试场景中,若实体类包含 byte[] 类型字段(如 Category.picture),YAML 数据集文件不能使用 \xHH 十六进制语法、十六进制字符串或裸 ASCII 表示——这些格式均无法被 DB Rider 正确解析为字节数组。Database Rider 内部依赖 Jackson 进行 YAML 反序列化,而 Jackson 对 byte[] 的默认反序列化策略仅接受 Base64 编码的字符串(RFC 4648 标准)。
✅ 正确做法:将原始字节内容(如 "Lorem ipsum".getBytes(StandardCharsets.UTF_8))编码为 Base64 字符串,并在 YAML 中作为普通字符串写入:
categories:
- id: 1
name: "Beverages"
description: "Soft drinks, coffees, teas, beers, and ales"
picture: TG9yZW0gaXBzdW0= # Base64 for "Lorem ipsum"
⚠️ 注意事项:
-
编码必须使用 UTF-8 字节:确保原始字符串按
StandardCharsets.UTF_8转换为字节,避免平台默认编码导致不一致; -
不可省略等号(
=)填充符:Base64 必须是合法、完整(含填充)的编码,否则 Jackson 反序列化会抛出IllegalArgumentException; -
H2 数据库兼容性:H2 的
BINARY或VARBINARY列可直接接收 Base64 解码后的字节,无需额外配置;bytea是 PostgreSQL 专用类型,H2 中应使用BINARY; - 生成工具建议:在测试准备阶段,推荐用 Java 工具类统一生成:
import java.nio.charset.StandardCharsets;
import java.util.Base64;
public class DataSetEncoder {
public static void main(String[] args) {
String raw = "Lorem ipsum";
String b64 = Base64.getEncoder().encodeToString(raw.getBytes(StandardCharsets.UTF_8));
System.out.println(b64); // 输出:TG9yZW0gaXBzdW0=
}
}
? 总结:Database Rider 的 YAML 数据集对二进制字段采用「Base64 作为唯一受支持的文本表示」这一设计,既保障了 YAML 文件的可读性与跨平台安全性,也与 JDBC 驱动(包括 H2 和 PostgreSQL)的 getBytes() 行为完全对齐。务必摒弃十六进制直写思路,坚持“UTF-8 字节 → Base64 字符串”的标准转换流程。











