如何在Spring Data Relational的Criteria中绑定原生SQL函数条件？

问题根源 #

用Criteria.where("m.originator").is("BINARY('test')")时，is()方法会把传入的内容当作普通字符串值处理，自动添加引号包裹，导致生成的SQL不符合预期。要让BINARY/CAST这类函数作为原生SQL执行，需要明确告知框架不要将其视为普通值。

可行方案 #

方案1：直接使用expression()方法 #

Spring Data Relational的Criteria提供了expression()方法，允许直接传入原生SQL片段作为条件右侧，框架会原样嵌入SQL，不会额外添加引号：

// 生成的SQL：m.originator = BINARY('test')
Criteria criteria = Criteria.where("m.originator").expression("BINARY('test')");

CAST函数同理：

// 生成的SQL：m.age = CAST('25' AS UNSIGNED)
Criteria criteria = Criteria.where("m.age").expression("CAST('25' AS UNSIGNED)");

方案2：参数化绑定（规避SQL注入） #

如果函数参数是动态输入的（比如用户提交的内容），直接拼接字符串存在SQL注入风险，此时可以用BindMarker做参数绑定：

// 创建命名参数的绑定标记器
BindMarkers bindMarkers = BindMarkersFactory.named(":", 1);
BindMarker valueMarker = bindMarkers.next();

// 构造原生条件
Condition binaryCondition = Condition.just("m.originator = BINARY(" + valueMarker.getPlaceholder() + ")");
Criteria criteria = Criteria.from(binaryCondition);

// 执行查询时绑定参数值（以Spring Data JDBC的Query为例）
Query query = Query.query(criteria).bind(valueMarker.getPlaceholder(), "test");

生成的SQL为m.originator = BINARY(:p1)，参数值通过绑定传入，既安全又能正确执行原生函数。

方案3：封装自定义Condition（复用场景） #

如果需要多次使用这类原生函数条件，可以封装成通用工具方法：

public static Condition binaryEquals(String column, String value) {
    BindMarkers bindMarkers = BindMarkersFactory.named(":", 1);
    BindMarker marker = bindMarkers.next();
    return Condition.just(String.format("%s = BINARY(%s)", column, marker.getPlaceholder()))
            .bind(marker.getPlaceholder(), value);
}

// 使用示例
Criteria criteria = Criteria.from(binaryEquals("m.originator", "test"));

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