Neo4j APOC 插件安装与配置实战指南

前置准备

确保 Neo4j 服务端版本与 APOC 插件版本一致。APOC 支持 Neo4j 4.x 及 5.x 系列，建议优先使用 5.x 以获得更好的兼容性。

安装步骤

1. 确认版本 在 Neo4j Desktop 或命令行执行以下命令查看当前内核版本：

CALL dbms.components() YIELD name, versions RETURN versions;

记录下返回的版本号，后续下载插件时需严格匹配。

2. 下载插件 前往 GitHub Releases 页面，选择与 Neo4j 主版本一致的 apoc-x.x.x.x-all.jar 文件。例如 Neo4j 5.x 对应 APOC 5.x 版本。

3. 部署文件 将下载的 jar 包放入 Neo4j 安装目录下的 plugins 文件夹中。 路径示例：<Neo4j_Install_Path>/plugins/

4. 修改配置 编辑 conf/neo4j.conf 文件，添加以下配置以启用 APOC 过程：

# 允许所有 APOC 函数调用
dbms.security.procedures.unrestricted=apoc.*

注意：Neo4j 5.x 对安全策略要求更严，部分元数据函数可能需要单独授权。

验证安装

重启服务后，在浏览器控制台执行以下查询：

RETURN apoc.version() AS version;

若返回版本号，说明插件加载成功。进一步测试元数据功能：

CALL apoc.meta.graph() YIELD nodes, relationships RETURN nodes, relationships;

成功返回图谱结构即表示配置无误。

常见问题

如果在运行过程中遇到初始化失败，通常是 Neo4j 5.x 的配置隔离机制导致的。新版要求 APOC 相关配置独立存储在 apoc.conf 文件中，而非直接写在 neo4j.conf 里。

解决方法：

1. 在 conf 目录下新建 apoc.conf 文件。
2. 将原本放在 neo4j.conf 中的 APOC 配置项移至该文件。
3. 确保包含核心设置，例如：

   # APOC 核心配置
   apoc.import.file.enabled=true
   dbms.security.procedures.unrestricted=apoc.*
   

保存后重启服务即可生效。