运行EXTENSION_SCRIPT后Neo4J Docker容器无法启动求助

我帮你分析下为啥设置了EXTENSION_SCRIPT之后Neo4j容器启动失败，咱们一步步来排查解决：

第一步：先看容器日志，定位具体错误 #

容器启动失败的核心是要先拿到错误信息，执行这条命令查看日志：

docker logs zz-neo4j-01

日志里会明确告诉你是脚本找不到、权限不够，还是脚本执行出错，这是最关键的第一步。

常见问题及解决办法 #

1. 脚本权限不足 #

官方Neo4j 3.3.4镜像默认用neo4j用户运行容器，如果你只是把脚本复制到容器里，可能没有执行权限，或者所属用户不对，导致脚本无法运行。修改你的Dockerfile，添加权限配置：

FROM neo4j:3.3.4
ADD zz-docker/neo4j/neo4j-init.sh /scripts/
# 给脚本添加执行权限，并确保neo4j用户拥有它
RUN chmod +x /scripts/neo4j-init.sh && chown neo4j:neo4j /scripts/neo4j-init.sh
EXPOSE 7474
EXPOSE 7687

2. 脚本路径或Docker上下文配置错误 #

检查你的项目结构是否和docker-compose的context匹配：
你的docker-compose.yml里context: ../，意味着构建镜像时以上级目录为上下文，那zz-docker/neo4j/neo4j-init.sh这个路径必须是相对于上级目录存在的，正确的项目结构应该是这样：

上级目录/
├── zz-docker/
│   └── neo4j/
│       ├── Dockerfile
│       └── neo4j-init.sh
├── docker-compose.yml
├── neo4j-data/
└── neo4j-logs/

如果路径不对，Dockerfile的ADD步骤会找不到脚本，容器里自然没有这个文件，启动就会失败。

3. 脚本内容有问题 #

EXTENSION_SCRIPT是Neo4j镜像用来在启动前执行自定义逻辑的，脚本里的错误会直接导致容器启动失败。注意这几点：

• 脚本开头必须加#!/bin/bash，否则可能无法被正确解析执行；
• 不要写阻塞进程的命令（比如tail -f这类），脚本必须能正常退出；
• 避免修改Neo4j的核心配置文件导致启动异常，比如错误修改neo4j.conf的参数。

举个简单的合法脚本示例（设置初始密码）：

#!/bin/bash
echo "Setting initial Neo4j password..."
neo4j-admin set-initial-password mySecurePassword123

4. 验证脚本是否存在于容器内 #

如果日志提示脚本找不到，可以先临时启动容器进入bash，检查脚本是否存在：

docker run --rm -it zz-neo4j bash
# 进入容器后执行
ls /scripts/

如果看不到neo4j-init.sh，说明Dockerfile的ADD步骤有问题，重新核对路径是否正确。

最后验证 #

修改完配置后，重新构建镜像并启动容器：

docker-compose build --no-cache
docker-compose up -d

然后用docker ps查看容器是否正常运行，再访问http://localhost:7474验证Neo4j是否能正常访问。

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