knex+PostgreSQL环境下query builder排序不生效的原因是什么？

• 优先修正whereRaw的语法错误
  你当前代码中的whereRaw语句缺少ANY表达式的闭合括号：

  // 错误写法
  builder.whereRaw(`${toSqlName('id')} = ANY(?::uuid[]`, [ids])
  // 修正后写法
  builder.whereRaw(`${toSqlName('id')} = ANY(?::uuid[])`, [ids])
  

  部分PostgreSQL版本对这类语法缺失存在解析容错，所以你之前的筛选逻辑可以正常运行，但语法错误会干扰后续链式方法的解析，是排序失效的常见诱因。
• 检查排序字段的命名转换适配
  你查询id字段时调用了toSqlName做命名转换（通常是驼峰转蛇形的业务适配逻辑），但排序时直接写死了username没有经过转换：如果你的表中实际存储的用户名字段是蛇形的user_name，排序时找不到对应字段不会主动报错，只会表现为排序不生效。修正写法如下：

  // orderBy版本，排序字段也传入toSqlName转换
  builder.whereRaw(`${toSqlName('id')} = ANY(?::uuid[])`, [ids])
    .orderBy(toSqlName('username'), 'desc')
  // orderByRaw版本，用占位符避免注入风险
  .orderByRaw(`?? DESC`, [toSqlName('username')])
  

• 确认上层逻辑没有覆盖排序规则
  你当前返回的是Knex Builder实例，可在调用链末尾打印最终生成的SQL确认排序语句是否存在：

  console.log(builder.toString())
  

  如果打印结果末尾没有ORDER BY相关语句，说明上层调用逻辑追加了其他orderBy、union操作或者重置了查询参数，覆盖了已经定义的排序规则。

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