解决字符串转bytea时单个反斜杠引发的SQL语法错误

方案一：使用AttributeConverter（推荐） #

放弃@ColumnTransformer，改用Hibernate属性转换器在Java层面处理字符串与bytea的转换，彻底避开SQL层面的转义问题。

1. 创建转换器类：

import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;
import java.nio.charset.StandardCharsets;

@Converter(autoApply = false)
public class StringToByteaConverter implements AttributeConverter<String, byte[]> {

    @Override
    public byte[] convertToDatabaseColumn(String agenda) {
        return agenda == null ? null : agenda.getBytes(StandardCharsets.UTF_8);
    }

    @Override
    public String convertToEntityAttribute(byte[] dbData) {
        return dbData == null ? null : new String(dbData, StandardCharsets.UTF_8);
    }
}

2. 修改实体类字段：

@Column(columnDefinition = "bytea")
@Convert(converter = StringToByteaConverter.class)
private String agenda;

该方案直接在Java层将字符串编码为UTF-8字节数组，Hibernate会自动映射为PostgreSQL的bytea类型；读取时反向解码，完全不受反斜杠等特殊字符影响。

方案二：修复@ColumnTransformer的SQL逻辑 #

如果必须保留原有base64存储方式，修改write语句的转换逻辑，用convert_to函数替代直接cast，避免PostgreSQL转义错误：

@ColumnTransformer(
    read = "convert_from(decode(agenda, 'base64'), 'UTF8')",
    write = "encode(convert_to(?, 'UTF8'), 'base64')"
)
private String agenda;

问题根源说明 #

原代码中?::bytea的强制转换会触发PostgreSQL的字符串转义规则，单反斜杠会被视为无效转义序列导致语法错误。而convert_to(?, 'UTF8')会直接按UTF-8编码将字符串转换为bytea，无需处理转义，能正确识别所有字符。

之前尝试的replace方法无效，是因为SQL中未使用E'\\'这种转义字符串写法，导致反斜杠未被正确识别为目标字符。

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