版本兼容性说明
本文基于 Neo4j 5.x 系列编写，APOC 插件版本需与主程序保持一致。虽然主要面向 5.x，但 4.x 版本的操作逻辑基本通用。
1. 确认 Neo4j 版本
在启动 Neo4j Desktop 或命令行终端后，执行以下查询以确认当前数据库版本：
CALL dbms.components() YIELD name, versions RETURN versions;
确保后续下载的 APOC 版本与上述返回的主版本号（Major Version）严格匹配。例如，若 Neo4j 为 5.12.0，则应下载对应的 APOC 5.12.0 版本。
2. 下载 APOC 插件
访问 APOC 官方发布页获取对应版本的 JAR 包：
- GitHub Releases: neo4j-contrib/neo4j-apoc-procedures
选择与 Neo4j 版本一致的 apoc-x.x.x.x-all.jar 文件进行下载。
3. 部署插件文件
将下载好的 .jar 文件放入 Neo4j 安装目录下的 plugins 文件夹中。典型路径如下：
<Neo4j_Install_Path>/plugins/
# 例如：C:\Program Files\Neo4j\neo4j-community-5.x.x\plugins\
放置完成后，无需解压，直接保留 .jar 文件即可。
4. 修改配置文件
打开 Neo4j 的配置文件 conf/neo4j.conf，添加以下配置项以启用 APOC 功能：
# 允许 APOC 所有函数调用
dbms.security.procedures.unrestricted=apoc.*
# 显式启用元数据相关函数（可选，视具体需求而定）
dbms.security.procedures.allowlist=apoc.meta.data,apoc.*
注意：不同版本的 Neo4j 对安全策略的要求可能略有差异，建议参考官方文档的最新说明。
5. 重启服务并验证
保存配置后，重启 Neo4j 服务。启动成功后，可通过以下命令验证安装是否生效：
RETURN apoc.version() AS version;
若返回具体的版本号，说明插件加载成功。进一步测试核心功能：
CALL apoc.meta.graph() YIELD nodes, relationships RETURN nodes, relationships;
成功标志是能够正确返回图谱中的节点和关系元数据。
6. 常见问题排查
如果在配置上述步骤后运行初始化失败，或者遇到权限错误，通常是因为 Neo4j v5 对 APOC 的配置管理进行了调整。旧版直接写在 neo4j.conf 中可能不再完全适用。
解决方案：
创建独立的 apoc.conf 配置文件。
- 在
conf/目录下新建文件apoc.conf。 - 将原本计划写入
neo4j.conf的 APOC 相关配置迁移至此文件中。 - 内容示例：
# APOC 核心配置
apoc.import.file.enabled=true
dbms.security.procedures.unrestricted=apoc.*
完成上述操作后再次重启服务，通常可解决配置不生效的问题。