使用apoc.nodes.cycles遇ProcedureNotFound错误求助

问题背景 #

调用apoc.nodes.cycles时提示找不到该存储过程，查询已存在的存储过程列表确认无此函数，但官方文档显示该函数存在。当前APOC版本为5.12.0，Neo4j版本实际为5.12.0（版本理论兼容）。

具体排查步骤 #

• 确认APOC安装包类型：apoc.nodes.cycles属于APOC扩展功能，仅安装APOC核心包（apoc-core）会缺失该存储过程。检查Neo4j的plugins目录，确保存在apoc-extended-5.12.0.jar，若只有核心包，替换为对应版本的完整扩展包。
• 检查Neo4j配置文件：确保neo4j.conf中已正确开启APOC权限：

  dbms.security.procedures.unrestricted=apoc.*
  dbms.security.procedures.allowlist=apoc.*
  

  修改配置后必须重启Neo4j服务才会生效。
• 验证函数加载状态：执行Cypher语句CALL apoc.help('cycles')，若返回空结果，说明该函数未被加载；若返回函数的详细信息，需检查自身调用语法是否有误。
• 精准查询存储过程列表：使用以下语句过滤相关存储过程，避免遗漏：

  SHOW PROCEDURES YIELD name WHERE name STARTS WITH 'apoc.nodes'
  

• 确认版本完全匹配：确保APOC包的版本号与Neo4j版本完全一致（包括小版本），比如apoc-extended-5.12.0.jar必须对应Neo4j 5.12.0，不能混用同大版本下的其他子版本。

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