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

Neo4j 版本：Neo4j 5.x apoc 版本：同上对应

Neo4j 4.x 版本同样适用

APOC 插件安装

1. 确认版本

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

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

根据返回结果确定主版本号。

2. 下载插件

访问 APOC GitHub Releases，下载与 Neo4j 版本一致的 apoc-x.x.x.x-all.jar 文件。

例如 Neo4j 5.12.0 对应 APOC 5.12.0。

或者点击下载对应的版本（如下图所示）。

3. 部署文件

将下载的 jar 包放置到 Neo4j 安装路径下的 plugins 文件夹中。

路径示例：C:\Program Files\Neo4j\neo4j-community-5.26.8\plugins\

4. 修改配置

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

参考官方的技术手册。

在文件中添加下面两行：

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

5. 重启服务

保存后重启 Neo4j 服务，然后进行验证。

安装验证

版本匹配：确保您的 Neo4j 版本也是 5.26.x 系列（截图显示 APOC 5.26.8）。

在 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.*