Objection/Knex链式where+orWhere失效，orWhereExists正常的问题排查

需要筛选出拥有满足以下任一条件的GymOutlets的GymGroups：名称包含指定子串，或地址包含指定子串。

尝试第一种写法时，返回了所有GymGroups条目（单独使用where可正常工作）：

await this.gymGroupModel
  .query()
  .whereExists(
    this.gymGroupModel
      .relatedQuery('gymOutlets')
      .where('address', 'ilike', `%${substring}%`)
      .orWhere('name', 'ilike', `%${substring}%`),
  )
  .orderBy('name', 'ASC');

但第二种写法可正常返回预期结果：

await this.gymGroupModel
  .query()
  .whereExists(
    this.gymGroupModel
      .relatedQuery('gymOutlets')
      .where('name', 'ilike', `%${substring}%`),
  )
  .orWhereExists(
    this.gymGroupModel
      .relatedQuery('gymOutlets')
      .where('address', 'ilike', `%${substring}%`),
  )
  .orderBy('name', 'ASC');

此外，直接对GymModel使用第一种逻辑的写法也能返回预期结果：

await this.gymModel
  .query()
  .where('address', 'ilike', `%${substring}%`)
  .orWhere('name', 'ilike', `%${substring}%`);

请问为何第一种写法失效，正确的实现方式是什么？

第一种写法失效的核心问题是**whereExists子查询里的orWhere没有被正确限定关联条件**。

当你用relatedQuery('gymOutlets')时，Objection.js会自动在子查询里加上GymGroup和GymOutlets的关联条件（比如gym_outlets.gym_group_id = gym_groups.id）。但你直接在.where(...)后接.orWhere(...)时，这个orWhere会直接和关联条件形成“或”的逻辑，导致子查询生成的SQL逻辑等价于：

EXISTS (
  SELECT * FROM gym_outlets 
  WHERE (gym_outlets.gym_group_id = gym_groups.id AND address ILIKE '%xxx%') 
    OR name ILIKE '%xxx%'
)

由于AND的优先级高于OR，只要任意GymOutlets的名称匹配子串，不管它属于哪个GymGroup，所有GymGroups都会被返回——因为name ILIKE '%xxx%'会命中匹配的GymOutlets，关联条件被“或”逻辑绕开，最终EXISTS判断为真。

而直接对GymModel查询时没有这个问题，因为不存在跨表关联条件，where和orWhere都是针对当前表字段，逻辑是纯粹的“地址匹配 或 名称匹配”。

你有两种可靠的实现方式：

方式一：用where(builder)包裹或条件，修正逻辑优先级 #

把where和orWhere放在同一个where回调里，让它们形成一个整体，和关联条件保持AND关系：

await this.gymGroupModel
  .query()
  .whereExists(
    this.gymGroupModel
      .relatedQuery('gymOutlets')
      .where((builder) => {
        builder.where('address', 'ilike', `%${substring}%`)
               .orWhere('name', 'ilike', `%${substring}%`);
      }),
  )
  .orderBy('name', 'ASC');

生成的SQL会是：

EXISTS (
  SELECT * FROM gym_outlets 
  WHERE gym_outlets.gym_group_id = gym_groups.id 
    AND (address ILIKE '%xxx%' OR name ILIKE '%xxx%')
)

逻辑变为：存在属于当前GymGroup的GymOutlets，且该GymOutlets的地址或名称匹配子串，符合预期。

方式二：使用两个whereExists+orWhereExists（已验证有效） #

这种写法逻辑清晰，每个whereExists单独检查一个条件，再用or连接两个存在判断，也能正确得到预期结果：

await this.gymGroupModel
  .query()
  .whereExists(
    this.gymGroupModel
      .relatedQuery('gymOutlets')
      .where('name', 'ilike', `%${substring}%`),
  )
  .orWhereExists(
    this.gymGroupModel
      .relatedQuery('gymOutlets')
      .where('address', 'ilike', `%${substring}%`),
  )
  .orderBy('name', 'ASC');

内容的提问来源于Stack Exchange，提问作者Nathan Tew