Neo4j子查询调用APOC过程提示变量n未定义报错如何解决

报错由两个语法规则冲突共同导致：

1. 带IN TRANSACTIONS的分批执行子查询是独立事务单元，不会自动继承外层查询的变量作用域，所有需要传入子查询的外层变量必须在子查询首行通过WITH显式声明。
2. 当子查询内部调用了带YIELD返回值的数据库过程（比如你用的apoc.create.setLabels）时，必须在子查询末尾写RETURN子句明确返回结果，否则Cypher解析器无法正确识别子查询的输入输出边界，会直接把首行WITH n里的n判定为子查询内部未定义的变量，最终抛出Variable n not defined的语法错误。

补全子查询的返回子句即可正常执行，修正后的语句如下：

:auto MATCH (n:TempNode)
CALL {
    WITH n
    CALL apoc.create.setLabels( n, [ n.type ] ) YIELD node
    RETURN node
} IN TRANSACTIONS;

额外注意事项 #

• 如果待处理的TempNode节点量较大，可以在IN TRANSACTIONS后追加OF <批次大小> ROWS参数（比如IN TRANSACTIONS OF 1000 ROWS），控制单事务处理的数据量，避免事务内存溢出。
• apoc.create.setLabels会直接覆盖节点的全部原有标签，如果你的需求是保留节点原有标签、仅新增n.type对应的动态标签，需要替换为apoc.create.addLabels函数，避免原有标签丢失。
• 如果你使用的是Neo4j 5.0及以上版本，可以不依赖APOC库，直接用原生过程实现动态标签设置：

  :auto MATCH (n:TempNode)
  CALL {
      WITH n
      CALL db.create.setNodeLabels(n, [n.type]) YIELD node
      RETURN node
  } IN TRANSACTIONS OF 1000 ROWS;
  

内容的提问来源于stack exchange，提问作者Martin Preusse