DB Rider 不支持 YAML 中直接使用十六进制（如 \x4c6f...）表示字节数组，必须将二进制数据 Base64 编码后写入 YAML，才能被 rs.getBytes() 正确解析为原始 byte[]。
db rider 不支持 yaml 中直接使用十六进制（如 `\x4c6f...`）表示字节数组，必须将二进制数据 base64 编码后写入 yaml，才能被 `rs.getbytes()` 正确解析为原始 `byte[]`。
在基于 Database Rider + H2 + Spring JDBC 的测试中，当实体字段（如 Category.picture: byte[]）需通过 YAML 数据集预置二进制数据时，不能使用 \xHHHH 十六进制转义或原始字符串——DB Rider 默认不解析此类语法，会导致 rs.getBytes("picture") 返回 null 或错误字节序列。
✅ 正确做法是：将原始字节数组进行 Base64 编码，并以纯字符串形式写入 YAML。DB Rider 内置支持 Base64 解码（自 v1.30.0 起默认启用），会在插入数据库前自动还原为 byte[]，与 H2 的 BINARY 或 VARBINARY 类型完全兼容。
示例：从字符串生成 Base64 并写入 YAML
假设原始内容为 "Lorem ipsum"（UTF-8 编码后共 11 字节）：
// Java 端生成 Base64 字符串（推荐在测试工具类或构建脚本中复用）
String base64 = Base64.getEncoder()
.encodeToString("Lorem ipsum".getBytes(StandardCharsets.UTF_8));
// 输出：TG9yZW0gaXBzdW0=对应 categories.yml 应写作：
categories:
- id: 1
name: "Beverages"
description: "Soft drinks, coffees, teas, beers, and ales"
picture: TG9yZW0gaXBzdW0=✅ 注意：
picture字段值为普通 YAML 字符串（无引号亦可），无需任何前缀（如base64:）、无空格、无换行。DB Rider 会自动识别并解码。
验证与注意事项
-
H2 兼容性：确保数据库列类型为
VARBINARY或BINARY（非VARCHAR），例如建表语句：CREATE TABLE categories ( id BIGINT PRIMARY KEY, name VARCHAR(255), description VARCHAR(1024), picture VARBINARY(4096) );
-
编码一致性：务必使用
StandardCharsets.UTF_8（或其他明确字符集）生成字节数组，避免平台默认编码差异。 -
空值处理：若字段允许
NULL，YAML 中直接写picture:（冒号后无值）或省略该字段即可。 -
大文件场景：对于较大二进制数据（如图片），建议在 CI/CD 中预生成 Base64 并存为
.yml片段，避免手动拼接出错。
总结
DB Rider 的 YAML 数据集对二进制字段采用「Base64 编码字符串」作为标准序列化格式，这是跨平台、跨数据库、符合 YAML 规范的安全方案。放弃 \xHH 或十六进制字符串尝试，统一使用 Base64.getEncoder().encodeToString(...) 生成值，即可确保 rs.getBytes() 精确还原原始字节数组，让集成测试真正具备可重复性与可靠性。
