使用neo4j/graphql查询Process返回空数组问题求助

Schema结构 #

type Process @query(read: true, aggregate: true) {
  material_id: String
  batch_id: String
  basic_mat: String
  happened: Date
}

执行的GraphQL查询 #

query Processes($where: ProcessWhere) {
  processes(where: $where) {
    basic_mat
    material_id
    batch_id
  }
}

查询变量 #

{ 
  "where": {
    "batch_id": "abc101"
  }
}

调试输出 #

@neo4j/graphql:auth using JWT provided in context: undefined +0ms
@neo4j/graphql:execution executing cypher +0ms
@neo4j/graphql:execution CALL dbms.components() YIELD versions, edition UNWIND versions AS version RETURN version, edition +1ms
@neo4j/graphql:execution cypher params: {} +0ms
@neo4j/graphql:translate ReadOperation
@neo4j/graphql:translate |──── PropertyFilter [batch_id] <EQ>
@neo4j/graphql:translate |──── AttributeField <basic_mat>
@neo4j/graphql:translate |──── AttributeField <material_id>
@neo4j/graphql:translate |──── AttributeField <batch_id> +0ms
@neo4j/graphql:execution executing cypher +655ms
@neo4j/graphql:execution MATCH (this:Process)
@neo4j/graphql:execution WHERE this.batch_id = $param0
@neo4j/graphql:execution RETURN this { .basic_mat, .material_id, .batch_id } AS this +0ms
@neo4j/graphql:execution cypher params: { param0: 'abc101' } +0ms
@neo4j/graphql:execution Execute successful, received 0 records +0ms

核心问题：调试生成的Cypher语句在Neo4j中执行能得到结果，但使用neo4j/graphql库查询却返回空数组，原因是什么？

• 数据库上下文不一致：确认neo4j/graphql连接的数据库实例、库名和手动执行Cypher的环境完全一致，避免连接到测试库或其他实例。
• 权限与访问控制差异：尽管调试显示JWT为undefined，但检查Neo4j是否开启了权限体系，neo4j/graphql使用的账号是否拥有Process节点的读权限，是否存在行级权限限制导致数据无法返回。
• 数据匹配细节问题：检查数据库中batch_id的实际值，是否存在大小写不匹配、首尾空格（如abc101 vs abc101）、数据类型不一致（如数据库中是数值类型，参数传字符串）等情况。
• 库版本bug：部分旧版neo4j/graphql可能存在Cypher参数绑定或生成逻辑的bug，尝试升级到最新稳定版本后重新测试。
• 事务上下文差异：确认neo4j/graphql是否在未提交的事务中执行查询，导致无法读取最新数据；手动执行Cypher时是否处于不同的事务环境。
• 节点标签大小写问题：Neo4j节点标签区分大小写，检查数据库中节点的标签是否为Process（而非小写process或其他变体），neo4j/graphql生成的Cypher严格匹配Process标签。

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