Neo4j 插件 APOC 安装及配置指南
环境说明
- Neo4j 版本:5.x(4.x 版本同样适用)
- APOC 版本:与 Neo4j 版本保持一致
1. 查看 Neo4j 版本
在 Neo4j Desktop 或命令行中执行:
CALL dbms.components() YIELD name, versions RETURN versions;
2. 下载 APOC 插件
访问 APOC 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 所有函数
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。
解决方案:
- 在同一目录 (
conf/) 下新建文件apoc.conf。 - 将原
neo4j.conf中的 APOC 配置移至此文件。
# APOC 核心配置
apoc.import.file.enabled=true
dbms.security.procedures.unrestricted=apoc.*


