Neo4j 插件 APOC 安装及配置

APOC 插件安装

Neo4j 版本：Neo4j 5.x（4.x 版本同样适用） APOC 版本：与 Neo4j 版本对应

1. 首先查看 Neo4j 版本（在 Neo4j Desktop 或命令行中执行）：

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

2. 然后去 GitHub 上下载这个插件：

• 访问 APOC GitHub Releases
• 下载与 Neo4j 版本一致的 apoc-x.x.x.x-all.jar 文件（例如 Neo4j 5.12.0 → APOC 5.12.0）

3. 然后放置到插件目录下：

Neo4j 安装路径下的 plugins 文件夹 Neo4j 安装目录/plugins/ 例如：C:\Program Files\Neo4j\neo4j-community-5.26.8\plugins\

4. 最后修改配置文件 (conf/neo4j.conf)： 参考官方的技术手册。在文件中添加下面两行：

# 允许 APOC 所有函数
dbms.security.procedures.unrestricted=apoc.*
# 显式启用 apoc.meta.data()，启用元数据函数
dbms.security.procedures.allowlist=apoc.meta.data,apoc.*

5. 重启 Neo4j 服务，然后进行验证。

安装验证

版本匹配：确保您的 Neo4j 版本也是 5.26.x 系列

在 Neo4j 浏览器执行：

RETURN apoc.version() AS version;

在用户数据库中执行：

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

成功标志：返回图谱节点和关系的元数据

常见问题

如果前面的成功了，但是运行代码的时候初始化失败，也就是安装过程出问题了，可以尝试以下解决方案：

Neo4j v5 要求所有 APOC 配置必须独立存储在 apoc.conf 文件中，而非主配置文件 neo4j.conf。

创建独立的 apoc.conf 文件：

• 在 同一目录 (conf/) 下新建文件 apoc.conf
• 将原 neo4j.conf 中删除的 APOC 配置移至此文件

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