如何解决Neo4j中‘procedure `gds.graph.create.cypher` not found’错误及版本兼容性问题

你遇到的问题大概率是GDS插件未正确部署到目标Neo4j数据库实例，或是版本兼容性不匹配导致的，下面是一步步的排查和解决方法：

1. 确认GDS插件已安装到对应数据库实例 #

Neo4j Desktop里每个数据库实例的插件是独立管理的，不是全局生效：

• 打开Neo4j Desktop，找到你正在使用的数据库实例
• 点击实例卡片上的Plugins标签
• 检查Graph Data Science插件是否显示为"Installed"状态，若未安装，点击"Install"按钮完成安装

2. 验证版本兼容性 #

你的Neo4j版本是4.4.5，对应的GDS兼容版本范围是1.8.x 到 2.1.x，你使用的GDS Playground 2.0.3在这个兼容区间内，但要确保数据库实例安装的GDS插件版本也符合要求：

• 在Plugins页面查看已安装的GDS版本，避免安装过高（比如2.2+仅兼容Neo4j 5.x）或过低（比如1.7及以下可能没有gds.graph.create.cypher过程）的版本

3. 检查过程是否存在并确认拼写 #

偶尔拼写错误也会触发这个报错，你可以在Neo4j Browser中运行以下命令，确认目标过程是否已注册：

CALL gds.list() YIELD name, description 
WHERE name CONTAINS 'create.cypher' 
RETURN name, description

如果没有返回结果，说明该过程确实未注册，回到前两步排查插件安装和版本问题。

4. 重启数据库实例 #

安装或更新GDS插件后，必须重启数据库才能让插件生效：

• 在Neo4j Desktop中停止当前运行的数据库实例，等待几秒后重新启动
• 重启完成后再次尝试调用gds.graph.create.cypher过程

5. 重新安装GDS插件（若以上步骤无效） #

如果插件安装后仍未生效，可能是安装过程出现异常：

• 在Plugins页面点击已安装的GDS插件旁的"Uninstall"按钮卸载
• 卸载完成后，重新点击"Install"选择兼容Neo4j 4.4的版本安装
• 安装完成后重启数据库

需要注意的是，GDS Playground只是前端交互工具，它的功能完全依赖于后端Neo4j数据库中安装的GDS插件，只有后端插件部署正确、版本兼容，Playground才能正常调用对应的过程。

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