H2数据库向VARBINARY(255)字段插入字符串报错求助

别愁啦！我帮你梳理下H2里给VARBINARY(255)字段插入数据的正确姿势，顺便提一个很容易踩的坑：

首先排查最容易忽略的坑：表名USER是H2的保留关键字 #

H2数据库里USER是内置的保留字，如果你直接写INSERT INTO USER (...)，数据库会把它当成关键字而非表名，直接触发语法错误！解决办法是给表名加上双引号：

INSERT INTO "USER" (你的VARBINARY字段名) VALUES (...);

几种正确的VARBINARY数据插入写法 #

1. 使用十六进制字符串语法（SQL直接插入） #

H2支持用X'十六进制内容'的格式表示二进制数据，比如要插入字节0x010203，可以这么写：

INSERT INTO "USER" (binary_col) VALUES (X'010203');

如果你的原始数据是字符串，也可以先转成十六进制再用这个格式。

2. 使用CAST函数转换字符串为二进制 #

如果想直接把字符串转成对应的二进制字节（默认用UTF-8编码），可以用CAST函数：

INSERT INTO "USER" (binary_col) VALUES (CAST('你要转的字符串' AS VARBINARY(255)));

这里指定VARBINARY(255)是为了和字段类型匹配，避免潜在的长度问题。

3. 用JDBC PreparedStatement插入（代码层面更安全） #

如果是在Java代码里操作，强烈推荐用PreparedStatement的setBytes方法，既避免语法错误，还能防止SQL注入：

// 假设已经获取了数据库连接conn
String sql = "INSERT INTO \"USER\" (binary_col) VALUES (?)";
try (PreparedStatement pstmt = conn.prepareStatement(sql)) {
    // 准备要插入的字节数组
    byte[] binaryData = "测试数据".getBytes(StandardCharsets.UTF_8);
    pstmt.setBytes(1, binaryData);
    pstmt.executeUpdate();
} catch (SQLException e) {
    e.printStackTrace();
}

你可以先检查下是不是表名没加双引号的问题，再试试上面的插入写法，应该就能解决语法错误啦！

内容的提问来源于stack exchange，提问作者Бахтияр Сейдахметов