Macbook M2环境下Neo4j Docker容器安装APOC插件失败

1. 匹配APOC与Neo4j版本 #

Neo4j 4.4.14需要对应版本的APOC插件，必须严格匹配主版本号。请下载apoc-4.4.0.23.jar（适配Neo4j 4.4.x系列），确保文件名无额外后缀。

2. 修复本地挂载目录权限（Mac M2专属） #

Mac Docker挂载目录时易出现权限映射问题，导致容器内无法读取文件：

• 停止并删除现有容器：

  docker compose down
  

• 修改本地插件目录权限，匹配Neo4j容器内运行用户的UID/GID（7474）：

  chmod -R 775 ../data/neo4j-plugins
  sudo chown -R 7474:7474 ../data/neo4j-plugins
  

3. 简化docker-compose配置（推荐） #

移除手动挂载plugins目录的配置，改用Neo4j官方自动安装机制，避免权限问题：

neo4j:
    image: neo4j:4.4.14
    container_name: neo4j
    ports:
      - 7473:7473
      - 7474:7474
      - 7687:7687
    volumes:
      - "../data/neo4j:/var/lib/neo4j/data"
    environment:
      - NEO4J_AUTH=neo4j/letoai
      - NEO4J_ACCEPT_LICENSE_AGREEMENT=yes
      - NEO4JLABS_PLUGINS=["apoc"]
      - NEO4J_dbms_security_procedures_whitelist=apoc.*
      - NEO4J_dbms_security_procedures_unrestricted=apoc.*

配置修改后，Neo4j会自动下载适配版本的APOC插件到容器内部。

4. 验证插件加载状态 #

启动容器后，访问Neo4j浏览器（http://localhost:7474），执行Cypher命令验证：

RETURN apoc.version() AS apocVersion

返回版本号即说明插件加载成功。

内容的提问来源于stack exchange，提问作者Santiago Galiano Segura