Neo4j 插件 APOC 安装及配置指南

环境说明

• Neo4j 版本：5.x（4.x 版本同样适用）
• APOC 版本：需与 Neo4j 版本一致

APOC 插件安装

1. 查看 Neo4j 版本 在 Neo4j Desktop 或命令行中执行以下命令：

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

2. 下载插件 访问 GitHub Releases 页面，下载与 Neo4j 版本一致的 apoc-x.x.x.x-all.jar 文件。 例如：Neo4j 5.12.0 → APOC 5.12.0

3. 放置插件 将下载的 jar 包放入 Neo4j 安装路径下的 plugins 文件夹。 路径示例：Neo4j 安装目录/plugins/

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

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

5. 重启服务 重启 Neo4j 服务使配置生效。

安装验证

在 Neo4j 浏览器执行以下命令检查版本：

RETURN apoc.version() AS version;

在用户数据库中执行以下命令验证元数据功能：

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

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

常见问题

若运行代码时初始化失败，可能是配置问题。Neo4j v5 要求所有 APOC 配置独立存储在 apoc.conf 文件中，而非主配置文件 neo4j.conf。

解决方法：

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

配置内容如下：

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