GORM Gen框架中实现不区分大小写的模糊查询方案

在数据库查询中，模糊查询是常见的需求，而GORM Gen作为GORM的代码生成工具，为开发者提供了更类型安全的查询方式。本文将深入探讨如何在GORM Gen中实现不区分大小写的模糊查询（ILIKE）。

ILIKE与LIKE的区别

LIKE是SQL中标准的模糊匹配操作符，但它区分大小写。例如：

SELECT * FROM users WHERE name LIKE 'john%'

这条查询只会匹配以小写"john"开头的名字。

而ILIKE（Insensitive LIKE）是PostgreSQL等数据库特有的操作符，它不区分大小写。同样的查询：

SELECT * FROM users WHERE name ILIKE 'john%'

会匹配"John"、"JOHN"、"john"等各种大小写组合。

GORM Gen中的实现方案

虽然GORM Gen没有直接提供ILike方法，但我们可以通过以下两种方式实现：

1. 使用UnsafeFieldRaw方法

GORM Gen提供了field.NewUnsafeFieldRaw方法，允许我们直接使用原始SQL表达式：

field.NewUnsafeFieldRaw("name ILIKE ?", "test%")

这种方式灵活但需要谨慎使用，因为它绕过了类型安全检查。

2. 自定义构建查询条件

对于需要频繁使用ILIKE的场景，可以封装一个辅助函数：

func ILike(field field.String, value string) field.Expr {
    return field.NewUnsafeFieldRaw(field.ColumnName().String()+" ILIKE ?", value)
}

// 使用示例
_damage.Where(ILike(_damage.Name, "Hello%"))

数据库兼容性考虑

需要注意的是，ILIKE并非所有数据库都支持：

• PostgreSQL：原生支持
• MySQL：默认不支持，可用LOWER()函数模拟
• SQLite：使用LIKE配合COLLATE NOCASE
• SQL Server：使用LIKE配合特定排序规则

在跨数据库应用中，建议使用数据库函数来保证兼容性，例如：

field.NewUnsafeFieldRaw("LOWER(name) LIKE LOWER(?)", "test%")

最佳实践建议

1. 明确需求：确定是否真的需要不区分大小写的查询，因为ILIKE通常比LIKE性能稍差

2. 索引优化：对经常使用ILIKE的列考虑使用函数索引（如PostgreSQL的CREATE INDEX idx_name ON users (LOWER(name))）

3. 代码组织：将常用的查询条件封装成可复用的函数，提高代码可维护性

4. 测试覆盖：特别是跨数据库应用，需要确保查询在不同数据库下的行为一致

通过以上方法，开发者可以在GORM Gen中灵活实现不区分大小写的模糊查询需求，同时保持代码的类型安全和可维护性。