Cypher执行报错：Variable line未定义问题排查与解决

这个报错的核心原因是APOC过程的作用域隔离：当你调用apoc.do.when并YIELD结果后，原来的line变量并不会自动延续到后续的查询阶段——只有在apoc.do.when的分支里明确返回的内容，才会通过value对象传递出来。

问题根源拆解 #

你在LOAD CSV时定义的line变量，只存在于调用apoc.do.when之前的作用域里。一旦进入apoc.do.when执行分支逻辑，外部的line虽然可以作为参数传入过程内部，但过程执行完成后，外部的line变量就会被“丢弃”，后续的WITH语句自然找不到它。

具体修复方案 #

要保留line变量，你需要在apoc.do.when的两个分支（true和false分支）里，把line和你需要的结果一起返回，然后从YIELD的value对象中提取它。

示例修改前后对比

假设你的原始代码类似这样：

LOAD CSV WITH HEADERS FROM 'file:///data.csv' AS line
CALL apoc.do.when(
  line.type = 'A',
  'MATCH (a:NodeA {id: line.id}) RETURN a AS r',
  'MATCH (b:NodeB {id: line.id}) RETURN b AS r',
  {line: line}
) YIELD value
WITH value.r AS r, line  // 这里触发"Variable line not defined"错误
// 后续的查询逻辑

修改后的代码：

LOAD CSV WITH HEADERS FROM 'file:///data.csv' AS line
CALL apoc.do.when(
  line.type = 'A',
  'MATCH (a:NodeA {id: line.id}) RETURN a AS r, line AS line',
  'MATCH (b:NodeB {id: line.id}) RETURN b AS r, line AS line',
  {line: line}
) YIELD value
WITH value.r AS r, value.line AS line  // 从value中提取line变量
// 后续的查询逻辑

或者更简洁地用映射返回：

LOAD CSV WITH HEADERS FROM 'file:///data.csv' AS line
CALL apoc.do.when(
  line.type = 'A',
  'MATCH (a:NodeA {id: line.id}) RETURN {r: a, line: line}',
  'MATCH (b:NodeB {id: line.id}) RETURN {r: b, line: line}',
  {line: line}
) YIELD value
WITH value.r AS r, value.line AS line
// 后续的查询逻辑

关键注意事项 #

• 必须保证apoc.do.when的两个分支都返回line，否则如果某个分支遗漏，后续value.line会变成null，可能引发新的问题。
• 不要依赖过程外部的变量延续到YIELD之后，所有需要在后续使用的变量，都要通过过程的返回结果传递。

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