求助：基于APOC的动态标签Cypher批量查询不生效及优化方案

查询在程序传参场景下完全无写入，是三个机制问题叠加导致的：

• apoc.do.case 这类动态执行过程，默认不会自动继承外部作用域的变量，你在动态Cypher片段里引用的n1、row根本没有传入动态脚本的上下文，执行时无法定位到目标节点，自然不会触发写入
• apoc.do.case 的参数结构不符合要求：该过程要求传入的条件列表必须是「条件-执行片段」成对结构，最后必须附带一个所有条件都不满足时的兜底执行片段，你之前只写了一组条件和对应脚本，没有兜底分支，会直接导致过程执行失败
• 你之前在Neo4j浏览器手动测试时能正常运行，是因为手动构造的临时参数碰巧补全了缺失的分支逻辑、变量传递要求，但程序按照固定的代码结构传参执行时，就触发了参数不匹配、作用域缺失的问题。这类apoc过程的执行失败如果没有开启全局错误日志，会直接静默无写入，不会抛出明确报错

补全apoc.do.case的参数结构、显式传入外部变量后即可实现稳定写入：

UNWIND $attribs as row
CALL apoc.merge.node.eager(
  ["Entity", row.type_],
  {ent_id: row.ent_match_crit},
  {literal_forms: [row.literal_form]},
  {}
) YIELD node as n1
WITH n1, row
CALL apoc.do.case(
  [
    size(n1.literal_forms) >= 1,
    "MATCH (n) WHERE elementId(n) = $node_id SET n.literal_forms = apoc.coll.toSet(n.literal_forms + $new_form) RETURN n as node"
  ],
  // 兜底分支：新建节点场景无需额外操作
  "RETURN n1 as node",
  // 显式把外部需要的变量传入动态脚本上下文
  {node_id: elementId(n1), new_form: row.literal_form, n1: n1}
) YIELD value
RETURN value.node as processed_node

完全可以省去嵌套调用apoc.do.case的逻辑，通过静态Cypher路径实现完全等价的功能，减少动态脚本的编译、上下文切换开销，批量处理时性能提升明显，同时彻底规避动态脚本的作用域问题：

UNWIND $attribs as row
CALL apoc.merge.node.eager(
  ["Entity", row.type_],
  {ent_id: row.ent_match_crit},
  // 新建节点时直接初始化literal_forms属性
  {literal_forms: [row.literal_form]},
  // 匹配节点时暂不做属性修改，留到后续统一处理
  {}
) YIELD node as n1
WITH n1, row
// 统一执行集合去重逻辑：新建节点时数组是单元素，toSet操作不会改变结果；匹配到已有节点时自动追加新值并去重，完全等价原单条查询的ON CREATE/ON MATCH逻辑
SET n1.literal_forms = apoc.coll.toSet(n1.literal_forms + row.literal_form)
RETURN n1 as processed_node

• 方案优势：
  • 逻辑完全等价原单条查询：新建节点的初始值设置、匹配节点的集合去重追加效果和原逻辑完全一致
  • 所有执行路径都是静态Cypher，不存在动态脚本的变量作用域问题，在Neo4j浏览器和程序传参场景下执行结果完全一致
  • 减少一次apoc过程的嵌套调用，批量大数据量下的执行稳定性更高，不会出现动态脚本执行失败的静默问题
  • 完全符合动态标签的要求：依旧通过apoc.merge.node实现运行时根据传入值动态匹配、创建节点标签，没有放弃动态标签的核心能力

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