Neo4j中apoc.periodic.repeat正确用法及执行不生效排查

Neo4j初学者在使用apoc.periodic.repeat更新图数据时未得到预期结果，复现场景如下：

• 首先执行Cypher创建国家节点：

  MERGE (co:Country {id: #, capital: "capital city"})
  

• 随后执行Cypher，基于已有的国家节点创建对应首都城市节点：

  MATCH (co:Country) MERGE (c:City {name: co.capital })
  

为验证apoc.periodic.repeat的自动执行效果，先创建了一批数量多于现有城市节点的国家节点，再执行如下调度语句：

CALL apoc.periodic.repeat("create-cities","MATCH (co:Country) MERGE (c:City {name: co.capital})", 1)

执行后语句未创建新的City标签节点，返回结果中done字段值为false。

apoc.periodic.repeat的写法本身不存在语法或用法错误，异常是后台任务阻塞导致的：

• 当后台存在正在运行的长耗时apoc.periodic.iterate任务时，会占用APOC后台任务执行资源，阻塞或延迟新提交的重复调度任务执行，最终导致任务未按预期运行、返回done=false。

1. 在Neo4j Browser或Cypher Shell中执行:queries命令，查看当前所有运行中的查询与后台任务
2. 手动终止所有存量的、遗留的运行中APOC任务
3. 重新提交apoc.periodic.repeat调度语句，任务即可正常执行，完成缺失首都城市节点的创建。

日常使用APOC周期性任务时，建议每次提交新任务前先检查后台遗留任务状态，避免长耗时任务阻塞后续调度。

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