MyBatis-Plus 在 PostgreSQL 中使用 LIKE 模糊查询的注意事项

在使用 MyBatis-Plus 进行 PostgreSQL 数据库开发时，开发人员可能会遇到一个常见的错误："could not determine data type of parameter $1"。这个错误通常出现在使用 MyBatis-Plus 自带的注解进行 LIKE 模糊查询时。

问题分析

PostgreSQL 与 MySQL 在字符串处理函数上存在差异。MyBatis-Plus 默认提供的 LIKE 条件使用的是 MySQL 风格的 CONCAT 函数语法：

public static final String LIKE = "%s LIKE CONCAT('%%',#{%s},'%%')";

然而 PostgreSQL 的 CONCAT 函数实现与 MySQL 不同，导致在执行时无法正确识别参数类型。PostgreSQL 需要更明确的类型转换或使用特定的字符串连接操作符。

解决方案

方案一：自定义条件注解

可以仿照 MyBatis-Plus 对 Oracle 的特殊处理方式，为 PostgreSQL 创建专用的 LIKE 条件：

/**
 * PostgreSQL 风格的 LIKE 条件
 */
public static final String POSTGRESQL_LIKE = "%s LIKE CONCAT('%%',CAST(#{%s} AS TEXT),'%%')";

方案二：使用 PostgreSQL 的字符串连接操作符

PostgreSQL 支持使用 || 操作符进行字符串连接，可以这样定义：

public static final String POSTGRESQL_LIKE = "%s LIKE '%%' || #{%s} || '%%'";

方案三：在实体类中直接指定

在实体类字段注解中直接指定 PostgreSQL 兼容的 LIKE 语法：

@TableField(condition = "%s LIKE '%%' || #{%s} || '%%'")
private String name;

最佳实践建议

1. 数据库兼容性考虑：在开发跨数据库应用时，应该为每种数据库提供特定的 SQL 片段。

2. 统一管理：可以创建一个数据库方言处理器，根据当前使用的数据库类型自动选择正确的 SQL 语法。

3. 类型安全：PostgreSQL 对类型检查较为严格，在不确定类型时使用 CAST 显式转换可以避免很多问题。

4. 性能考量：LIKE 模糊查询特别是前导通配符(如 '%xxx')会导致全表扫描，在 PostgreSQL 中应考虑使用全文检索或专门的搜索引擎。

通过理解不同数据库的语法差异并采取适当的适配措施，可以确保 MyBatis-Plus 在各种数据库环境下都能正常工作。