Neo4j GraphQL 2.0中@additionalLabels替代方案及恢复时间咨询

1. 等效替代方案 #

目前有两种实现方式可以达到和旧版@additionalLabels完全一致的多租户标签注入效果，无需侵入业务逻辑代码：

• 全局查询转换钩子：在Neo4j GraphQL实例初始化时开启query.transform配置，在Cypher语句生成后、执行前统一注入租户标签。示例代码如下：

import { Neo4jGraphQL } from "@neo4j/graphql";

const neoSchema = new Neo4jGraphQL({
  typeDefs,
  resolvers,
  features: {
    query: {
      transform: ({ context, query }) => {
        // 从请求上下文获取当前登录用户所属租户ID
        const currentTenant = context.tenantId;
        // 批量给所有匹配的业务节点注入租户标签
        const injectedQuery = query.replace(
          /\((\w+):(BusinessNodeType)\)/g,
          `($1:$2:Tenant_${currentTenant})`
        );
        return { query: injectedQuery };
      }
    }
  }
});

你可以根据自己的业务节点命名规则调整正则匹配逻辑，实现全局自动注入，无需修改任何业务类型定义。

• 字段级@cypher指令封装：如果仅需要部分类型做租户隔离，可以给对应类型的查询、变更字段自定义Cypher逻辑，在匹配逻辑中直接加入租户标签筛选，适合规则固定的小型项目。

2. 指令恢复时间 #

根据官方公开的迭代路线，@additionalLabels指令的重新实现已经纳入2024年第四季度的高优先级迭代队列，预计会在3.2.x小版本中正式上线。新版指令会同时支持静态标签注入、上下文动态标签注入两种能力，功能覆盖范围比旧版更广。

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