Linux服务器启动Neo4j Docker时因APOC插件冲突失败

错误核心信息 #

无法注册存储过程，因为名称apoc.atomic.add已被占用。

问题原因 #

该错误是由于APOC插件的存储过程被重复加载导致，常见场景：

• Neo4j镜像本身内置了APOC，同时外部挂载的plugins目录又添加了APOC jar包
• 挂载的plugins目录中存在多个不同版本的APOC jar包

解决步骤 #

• 停止并清理异常容器：

  docker stop neo4j-container
  docker rm neo4j-container
  

• 检查本地挂载的plugins目录，删除所有重复或不匹配版本的APOC jar包，仅保留与Neo4j 5.2.0版本一致的APOC jar包（版本必须严格对应）
• 重新启动容器（根据实际挂载路径调整命令）：

  docker run -d \
    --name neo4j \
    -p 7474:7474 -p 7687:7687 \
    -v /your/local/data:/data \
    -v /your/local/plugins:/plugins \
    -e NEO4J_AUTH=neo4j/your-secure-password \
    neo4j:5.2.0
  

• 验证修复：容器启动后访问Neo4j浏览器，执行Cypher命令CALL apoc.help('atomic.add')，正常返回结果则说明问题已解决

内容的提问来源于stack exchange，提问作者DILIP KUMAR