Knex是否支持跨多列whereLike？如何实现多列模糊查询去重排序

核心实现代码 #

const searchQuery = 'J'; // 你的查询关键词

const employees = await knex('your_table_name')
  // 去重：根据业务需求选择字段，用主键去重更可靠
  .distinct('EmployeeNickname', 'EmployeeRealname', 'EmployeeInfo')
  // 构建OR条件组，实现多规则匹配
  .where(function() {
    this.where('EmployeeNickname', 'like', `${searchQuery}%`) // 昵称前缀匹配
      .orWhere('EmployeeRealname', 'like', `${searchQuery}%`) // 真名前缀匹配
      .orWhere('EmployeeNickname', 'like', `%${searchQuery}%`); // 昵称包含匹配
  })
  // 自定义排序：按匹配优先级排序，同优先级下按昵称升序
  .orderByRaw(`
    CASE
      WHEN EmployeeNickname LIKE ? THEN 1
      WHEN EmployeeRealname LIKE ? THEN 2
      WHEN EmployeeNickname LIKE ? THEN 3
      ELSE 4
    END, EmployeeNickname ASC
  `, [`${searchQuery}%`, `${searchQuery}%`, `%${searchQuery}%`]);

关键细节解释 #

1. OR条件组：用where(function() { ... })包裹所有orWhere，确保这些匹配规则是逻辑或的关系，而不是默认的逻辑与。如果直接链式调用orWhere，在有其他where条件时容易出问题，用子构建器更安全。
2. 去重处理：distinct会自动过滤完全重复的行。如果你的表有主键（比如EmployeeId），优先用.distinct('EmployeeId')再关联查询其他字段，去重逻辑更准确。
3. 自定义排序：通过orderByRaw结合SQL的CASE WHEN给不同匹配规则设置优先级权重：
   • 昵称前缀匹配的行权重最高（排第1位）
   • 其次是真名前缀匹配（排第2位）
   • 最后是昵称包含匹配（排第3位）
   • 同权重的行再按EmployeeNickname升序排列，保证结果有序。
4. SQL注入防护：orderByRaw里用?占位符传递参数，Knex会自动做参数绑定，避免SQL注入风险。

可选优化 #

如果需要忽略大小写匹配（比如查询"j"也能匹配"John"），可以转成统一大小写后匹配：

.whereRaw('LOWER(EmployeeNickname) LIKE ?', [`${searchQuery.toLowerCase()}%`])
.orWhereRaw('LOWER(EmployeeRealname) LIKE ?', [`${searchQuery.toLowerCase()}%`])
.orWhereRaw('LOWER(EmployeeNickname) LIKE ?', [`%${searchQuery.toLowerCase()}%`])

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