Spring Boot JPA：如何修改十六进制属性的数据库存储方式

方法一：利用数据库内置函数替代X'语法（推荐） #

大部分数据库（如MySQL、PostgreSQL）提供了和X'语法等价的函数，比如MySQL的UNHEX()，可以直接在@ColumnTransformer或原生SQL中使用，避免单引号解析问题：

1. 实体类配置
   在对应属性上添加@ColumnTransformer，指定写入时用UNHEX()处理参数：

@Column(name = "SPECIAL_COLUMN")
@ColumnTransformer(write = "UNHEX(?)")
private String hexString;

Hibernate生成的插入SQL会自动变为：

insert into table (SPECIAL_COLUMN, NORMAL_COLUMN) values (UNHEX(?), ?)

UNHEX('1A2B')和X'1A2B'在MySQL中完全等价，可满足数据库需求。

2. 原生SQL查询写法
   如果用原生@Query，直接调用UNHEX()：

@Query(value = "insert into table (SPECIAL_COLUMN, NORMAL_COLUMN) values (UNHEX(?1), ?2)", nativeQuery = true)
void insertEntity(String hexStr, String normalCol);

方法二：自定义Hibernate类型生成X'语法 #

如果必须严格生成X'xxx'的SQL语法，可以自定义Hibernate类型，让它自动包裹参数：

1. 实现自定义类型

public class HexStringType extends AbstractSingleColumnStandardBasicType<String> {
    public HexStringType() {
        super(VarcharTypeDescriptor.INSTANCE, StringTypeDescriptor.INSTANCE);
    }

    @Override
    public String getName() {
        return "hex-string";
    }

    @Override
    protected String getSqlType() {
        return "varchar";
    }

    @Override
    public String objectToSQLString(String value, Dialect dialect) throws Exception {
        return "X'" + value + "'";
    }
}

2. 实体类中使用自定义类型

@Column(name = "SPECIAL_COLUMN")
@Type(type = "com.yourpackage.HexStringType")
private String hexString;

Hibernate生成插入SQL时，会自动把属性值用X'...'包裹，生成你期望的格式。

方法三：原生SQL结合字节数组参数 #

将十六进制字符串转换为字节数组，通过TypedParameterValue指定二进制类型，Hibernate会自动生成X'...'语法：

// 借助Apache Commons Codec的Hex类将十六进制字符串转成字节数组
byte[] hexBytes = Hex.decodeHex(entity.getHexString().toCharArray());

// 执行原生插入
entityManager.createNativeQuery("insert into table (SPECIAL_COLUMN, NORMAL_COLUMN) values (?, ?)")
        .setParameter(1, new TypedParameterValue(BinaryType.INSTANCE, hexBytes))
        .setParameter(2, entity.getNormalColumn())
        .executeUpdate();

这种方式既避免SQL注入风险，又能生成符合要求的X'xxx'语法。

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