Docker部署Neo4j时安装APOC插件失败的问题求助

生产与开发环境中通过Docker在虚拟机运行Neo4j 5.1.0社区版实例，尝试添加同版本的APOC插件，编写的Dockerfile如下：

FROM neo4j:5.1.0-community

ENV APOC_VERSION=5.1.0

ENV apoc.export.file.enabled=true
ENV apoc.import.file.enabled=true
ENV apoc.import.file.use_neo4j_config=true

ADD https://github.com/neo4j/apoc/releases/download/${APOC_VERSION}/apoc-${APOC_VERSION}-core.jar /plugins/

启动时出现失败，核心报错为：

java.util.zip.ZipException: Some jar procedure files (apoc-5.1.0-core.jar) are invalid, see log for details.

完整错误日志：

2023-04-26 18:54:34.915+0000 INFO Starting...
2023-04-26 18:54:35.881+0000 INFO This instance is ServerId{ac8140db} (ac8140db-4060-498a-818d-b7beaa3b826e)
2023-04-26 18:54:37.464+0000 INFO ======== Neo4j 5.1.0 ========
2023-04-26 18:54:41.802+0000 ERROR Failed to start Neo4j on 0.0.0.0:7474.
java.lang.RuntimeException: Error starting Neo4j database server at /data/databases
at org.neo4j.graphdb.facade.DatabaseManagementServiceFactory.startDatabaseServer(DatabaseManagementServiceFactory.java:255) ~[neo4j-5.1.0.jar:5.1.0]
at org.neo4j.graphdb.facade.DatabaseManagementServiceFactory.build(DatabaseManagementServiceFactory.java:193) ~[neo4j-5.1.0.jar:5.1.0]
at org.neo4j.server.CommunityBootstrapper.createNeo(CommunityBootstrapper.java:36) ~[neo4j-5.1.0.jar:5.1.0]
at org.neo4j.server.NeoBootstrapper.start(NeoBootstrapper.java:164) ~[neo4j-5.1.0.jar:5.1.0]
at org.neo4j.server.NeoBootstrapper.start(NeoBootstrapper.java:85) ~[neo4j-5.1.0.jar:5.1.0]
at org.neo4j.server.CommunityEntryPoint.main(CommunityEntryPoint.java:30) ~[neo4j-5.1.0.jar:5.1.0]
Caused by: org.neo4j.kernel.lifecycle.LifecycleException: Component 'org.neo4j.procedure.impl.GlobalProceduresRegistry@31db34da' was successfully initialized, but failed to start. Please see the attached cause exception "Some jar procedure files (apoc-5.1.0-core.jar) are invalid, see log for details.".
at org.neo4j.kernel.lifecycle.LifeSupport$LifecycleInstance.start(LifeSupport.java:370) ~[neo4j-common-5.1.0.jar:5.1.0]
at org.neo4j.kernel.lifecycle.LifeSupport.start(LifeSupport.java:92) ~[neo4j-common-5.1.0.jar:5.1.0]
at org.neo4j.graphdb.facade.DatabaseManagementServiceFactory.startDatabaseServer(DatabaseManagementServiceFactory.java:246) ~[neo4j-5.1.0.jar:5.1.0]
... 5 more
Caused by: java.util.zip.ZipException: Some jar procedure files (apoc-5.1.0-core.jar) are invalid, see log for details.
at org.neo4j.procedure.impl.ProcedureJarLoader.loadProceduresFromDir(ProcedureJarLoader.java:74) ~[neo4j-procedure-5.1.0.jar:5.1.0]
at org.neo4j.procedure.impl.GlobalProceduresRegistry.start(GlobalProceduresRegistry.java:338) ~[neo4j-procedure-5.1.0.jar:5.1.0]
at org.neo4j.kernel.lifecycle.LifeSupport$LifecycleInstance.start(LifeSupport.java:353) ~[neo4j-common-5.1.0.jar:5.1.0]
at org.neo4j.kernel.lifecycle.LifeSupport.start(LifeSupport.java:92) ~[neo4j-common-5.1.0.jar:5.1.0]
at org.neo4j.graphdb.facade.DatabaseManagementServiceFactory.startDatabaseServer(DatabaseManagementServiceFactory.java:246) ~[neo4j-5.1.0.jar:5.1.0]
... 5 more
2023-04-26 18:54:41.805+0000 INFO Neo4j Server shutdown initiated by request
2023-04-26 18:54:41.806+0000 INFO Stopped.

核心问题是APOC的jar文件无效，可能由下载损坏、权限错误或Docker命令使用不当导致，以下是针对性修复步骤：

1. 替换ADD命令为RUN curl确保下载完整性 #

Docker的ADD命令在下载远程文件时，若遇网络波动易生成不完整文件，改用RUN curl命令，可添加可选的校验步骤：

FROM neo4j:5.1.0-community

ENV APOC_VERSION=5.1.0

ENV apoc.export.file.enabled=true
ENV apoc.import.file.enabled=true
ENV apoc.import.file.use_neo4j_config=true

# 使用curl下载APOC jar，可选添加SHA256校验
RUN curl -L --output /plugins/apoc-${APOC_VERSION}-core.jar \
    https://github.com/neo4j/apoc/releases/download/${APOC_VERSION}/apoc-${APOC_VERSION}-core.jar
    # 可选：替换为对应版本的SHA256值进行校验
    # && echo "xxxxxx  /plugins/apoc-${APOC_VERSION}-core.jar" | sha256sum -c -

2. 设置jar文件的正确权限 #

Neo4j默认以neo4j用户运行，需确保该用户拥有jar文件的读取权限，在Dockerfile中添加：

RUN chown neo4j:neo4j /plugins/apoc-${APOC_VERSION}-core.jar

3. 手动下载后拷贝到镜像（网络不稳定场景） #

若远程下载持续失败，可手动下载对应版本的APOC jar文件到Dockerfile同目录，改用COPY命令：

FROM neo4j:5.1.0-community

ENV APOC_VERSION=5.1.0

ENV apoc.export.file.enabled=true
ENV apoc.import.file.enabled=true
ENV apoc.import.file.use_neo4j_config=true

COPY apoc-${APOC_VERSION}-core.jar /plugins/
RUN chown neo4j:neo4j /plugins/apoc-${APOC_VERSION}-core.jar

4. 本地验证jar文件有效性 #

构建镜像前，可先在本地检查jar文件是否完好：

unzip -t apoc-5.1.0-core.jar

若解压报错，说明文件已损坏，重新下载即可。

内容的提问来源于stack exchange，提问作者Michał Bogusz