knex 本身没有内置的 `wherelike` 跨多列“或”匹配函数，但可通过链式调用 `orwherelike` 构建 or 条件，实现对多个字段的独立模糊搜索，避免重复行且保持查询高效。
在 Knex 中，连续使用 .whereLike() 会生成 SQL 的 AND 逻辑（即所有条件必须同时满足），这显然不符合“任一字段匹配即返回”的需求。要实现跨 EmployeeNickname 和 EmployeeRealname 等多个字段的并行模糊匹配，必须显式使用 .orWhereLike() —— 它会将后续条件以 OR 方式拼接到 WHERE 子句中，前提是它紧跟在首个 .where*() 调用之后（Knex 会自动将首次 .where*() 视为 WHERE，后续 .orWhere*() 视为 OR 分支）。
例如，针对查询关键词 "J"，期望匹配以下三类模式：
- EmployeeNickname 以 "J" 开头（'J%'）
- EmployeeRealname 以 "J" 开头（'J%'）
- EmployeeNickname 包含 "J"（'%J%'）
正确写法如下：
knex("TABLE1")
.select("EmployeeNickname", "EmployeeRealname", "EmployeeInfo")
.whereLike("EmployeeNickname", `${query}%`)
.orWhereLike("EmployeeRealname", `${query}%`)
.orWhereLike("EmployeeNickname", `%${query}%`)
.limit(20)
.offset(page) // 注意：offset 接收数字，无需字符串化
.orderBy("EmployeeNickname");⚠️ 关键注意事项：
- 顺序不可颠倒：首个条件必须是 .whereLike()，后续才可用 .orWhereLike()；若全部用 .orWhereLike()，Knex 可能生成无效 SQL（如无 WHERE 主干）；
- 防 SQL 注入：query 应预先校验或转义（Knex 不自动处理通配符注入），建议结合 knex.raw() 或正则预处理，例如拒绝 %, _, [, ] 等危险字符；
- 性能提示：%value% 类型的 LIKE 无法使用常规 B-Tree 索引，如需高频全文检索，建议搭配数据库全文索引（如 PostgreSQL 的 tsvector）或专用搜索引擎；
- 去重与排序：本方案天然不产生重复行（单行满足任一条件即返回一次），但 orderBy("EmployeeNickname") 仅按昵称排序；若需按匹配优先级（如“前缀匹配 > 全文包含”）自定义排序，需改用 orderByRaw 配合 CASE WHEN：
.orderByRaw(`
CASE
WHEN "EmployeeNickname" LIKE ? THEN 1
WHEN "EmployeeRealname" LIKE ? THEN 2
WHEN "EmployeeNickname" LIKE ? THEN 3
ELSE 4
END
`, [`${query}%`, `${query}%`, `%${query}%`])综上，.orWhereLike() 是 Knex 实现多字段 OR 模糊查询的标准、简洁且可靠的方式，合理组合可灵活支撑搜索场景，无需手动拼接原始 SQL。
