如何在Knex嵌套原生查询中正确转义PostgreSQL LTREE的?运算符

你碰到的这个问题确实挺典型的——Knex原生查询里的?占位符，刚好和PostgreSQL LTREE专属的?运算符撞车了，嵌套查询时转义规则的不一致更是让问题变得棘手。不用给生成函数加上下文参数，这里有几个通用的解决方案，不管嵌套多少层都能搞定：

方案1：用嵌套raw传递字面量?运算符 #

核心思路是把LTREE的?运算符包装成独立的knex.raw实例，作为参数传给外层raw。这样Knex会把它当成原生SQL片段直接插入，而不是解析为数据绑定占位符，无论嵌套层级多少都能保持正确的运算符格式：

const functionThatCreatesTheSubQuery = () => {
  // 用raw创建字面量的?运算符，避免被Knex解析为占位符
  const ltreeContainsOperator = knex.raw('?');
  // 外层raw使用??插入这个运算符片段
  const condition = knex.raw('columnWithLTree ?? array["Root.Noeud1"]::lquery[]', [ltreeContainsOperator]);
  return this.where(condition);
};

const existsQuery = knex.raw(
  knex.select('property')
    .from('table')
    .where(functionThatCreatesTheSubQuery())
).wrap('SELECT EXISTS (', ')');

生成的最终SQL会正确保留columnWithLTree ? array[...]的格式，Knex不会把这个?当成需要绑定数据的占位符。

方案2：自定义Knex辅助方法（长期优雅方案） #

如果项目里经常用到LTREE操作，建议封装一个自定义的Knex方法，把LTREE的操作逻辑封装起来，彻底避开转义问题：

// 扩展Knex的QueryBuilder，添加LTREE专属查询方法
knex.QueryBuilder.prototype.whereLtreeContains = function(column, lqueryArray) {
  const operator = knex.raw('?');
  return this.where(knex.raw('?? ?? ?::lquery[]', [column, operator, lqueryArray]));
};

// 调用时简洁又省心
const functionThatCreatesTheSubQuery = () => {
  return this.whereLtreeContains('columnWithLTree', ['Root.Noeud1']);
};

const existsQuery = knex.raw(
  knex.select('property')
    .from('table')
    .where(functionThatCreatesTheSubQuery())
).wrap('SELECT EXISTS (', ')');

这个方法把LTREE的操作逻辑封装起来，后续所有用到的地方都不用再纠结转义，代码可读性也更高。

方案3：直接使用PostgreSQL运算符全称（兜底方案） #

PostgreSQL的所有运算符都有对应的全称形式，LTREE的?运算符对应的是pg_catalog.ltree_exists（可以在psql中执行\do ?确认）。直接用全称代替?，完全避开占位符冲突：

const condition = knex.raw('columnWithLTree OPERATOR(pg_catalog.ltree_exists) array["Root.Noeud1"]::lquery[]');

这个方案不需要任何转义，缺点是运算符全称比较冗长，不过大部分主流PostgreSQL版本都支持这个写法。

这些方案都不需要依赖上下文参数，嵌套和非嵌套场景都能正常工作，你可以根据项目实际情况选择最合适的一种。

内容的提问来源于stack exchange，提问作者Jean-Baptiste Duriez