Directus项目中GraphQL嵌套过滤器使用问题解析

问题概述

在使用Directus的GraphQL接口时，开发者在尝试构建包含多个条件的嵌套过滤器查询时遇到了错误提示："The values in where clause must not be object or array"。这个问题主要出现在多对多(M2M)关系的查询场景中。

问题重现

典型的问题查询示例如下：

query pack {
  total_count: pack_item_aggregated(
    filter: {
      packs: {
        pack_id: { 
          slug: { _eq: "test" }, 
          status: { _in: ["published", "hidden"] } 
        }
      }
    }
  ) {
    countDistinct {
      id
    }
  }
}

这个查询尝试在pack_item_aggregated聚合查询中，通过packs关系过滤同时满足slug等于"test"且status在["published", "hidden"]范围内的记录。

问题原因

该问题的根本原因在于Directus的GraphQL查询编译器在处理嵌套过滤器时，未能正确解析多个条件的组合。当在同一层级中包含多个条件对象时，查询编译器会错误地尝试将这些条件对象直接传递给数据库查询构建器，而MySQL等数据库不允许WHERE子句直接接受对象或数组作为值。

解决方案

官方推荐的临时解决方案

Directus团队建议使用_and操作符将多个条件分开处理：

query pack {
  total_count: pack_item_aggregated(
    filter: {
      packs: {
        _and: [
          { pack_id: { slug: { _eq: "test" } } }
          { pack_id: { status: { _in: ["published", "hidden"] } } }
        ]
      }
    }
  ) {
    countDistinct {
      id
    }
  }
}

其他场景的解决方案

对于更复杂的查询场景，如包含函数条件和普通条件的组合，可以采用类似的分解方法：

{
  _and: [
    { degrees: { products_func: { count: { _gte: 1 } } } },
    { degrees: { products: { hide_in_overview: { _neq: true } } } },
    { degrees: { products: { status: { _eq: "published" } } } },
  ]
}

技术背景

在GraphQL查询中，过滤器条件的组合通常需要遵循特定的语法规则。Directus的GraphQL实现基于Knex.js查询构建器，而Knex在处理复杂条件时会将其转换为SQL WHERE子句。当遇到嵌套的对象结构时，如果没有正确的条件组合操作符（如_and、_or），查询构建器会尝试直接将对象作为值传递，从而导致错误。

最佳实践

1. 明确使用逻辑操作符：在组合多个条件时，始终使用_and或_or明确指定逻辑关系
2. 分解复杂条件：将同一字段的多个条件分解为单独的条件表达式
3. 优先使用简单条件：在可能的情况下，优先使用简单的等于或不等于条件
4. 测试查询结构：在构建复杂查询前，先测试简单的查询结构，逐步增加复杂度

总结

这个问题展示了在使用GraphQL接口进行复杂查询时需要注意的语法细节。通过使用明确的逻辑操作符和分解复杂条件，开发者可以构建出既符合语法要求又能准确表达查询意图的GraphQL查询语句。Directus团队已经意识到这个问题，预计在未来的版本中会提供更友好的错误处理和语法支持。