docker compose构建启动容器时自动执行Python脚本失败问题

容器启动后直接退出的核心原因有三点：

• jupyter/scipy-notebook基础镜像的默认启动命令是拉起Jupyter服务，你在Dockerfile中自定义的CMD/ENTRYPOINT直接覆盖了默认逻辑。而你的append_dependencies.py仅做路径添加操作，代码执行完进程就直接结束，容器主进程退出后容器自然会停止，不会保留Jupyter服务运行。
• 原配置存在路径不匹配问题：基础镜像默认工作目录为/home/jovyan，你在Dockerfile中写WORKDIR /work，和docker-compose里挂载的/home/jovyan/work路径不一致，也会导致脚本找不到、执行失败。
• 额外逻辑问题：append_dependencies.py中sys.path.append的配置仅对当前运行的Python进程生效，就算脚本执行成功，后续启动的Jupyter内核也不会继承这个路径配置，属于无效操作。

方案1：使用Jupyter镜像官方启动钩子（推荐） #

Jupyter官方镜像预留了启动前执行自定义逻辑的钩子目录，将自定义脚本放到/usr/local/bin/start-notebook.d/目录下，镜像默认启动流程会在拉起Jupyter服务前自动执行目录下所有脚本，执行完成后会正常启动Jupyter，不会出现容器退出的问题。
如果你的核心诉求是把/home/jovyan/work加入Python全局搜索路径，完全不需要单独写Python脚本，直接配置全局环境变量即可，配置更简单也更稳定：

1. 修改Dockerfile：

FROM jupyter/scipy-notebook

# 先复制依赖文件安装，利用Docker构建缓存减少重复构建
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt

# 不需要自定义CMD/ENTRYPOINT，保留镜像默认启动逻辑即可

2. 修改docker-compose.yml，在环境变量中添加PYTHONPATH配置，同时修正重复挂载的问题：

version: '3.7'

networks:
  george:

services:
  jupyter:
    build: .
    image: jupyter/scipy-notebook:latest
    environment:
      - JUPYTER_TOKEN=password
      - JUPYTER_ENABLE_LAB=yes
      - PYTHONPATH=/home/jovyan/work:$PYTHONPATH
    volumes:
      - .:/home/jovyan/work
    ports:
      - 7777:8888
    container_name: almond_analysis
    networks:
      - george

如果你确实需要执行append_dependencies.py中的其他自定义逻辑，只需要在Dockerfile中加两行把脚本复制到钩子目录即可：

COPY append_dependencies.py /usr/local/bin/start-notebook.d/
RUN chmod +x /usr/local/bin/start-notebook.d/append_dependencies.py

方案2：自定义启动命令串联执行逻辑 #

如果需要完全自定义启动流程，可以在启动命令中先执行自定义脚本，再拉起Jupyter服务，修改后的Dockerfile如下：

FROM jupyter/scipy-notebook

WORKDIR /home/jovyan

COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt

COPY . ./work/

# 先执行自定义脚本，脚本执行成功后启动Jupyter服务
CMD ["sh", "-c", "python /home/jovyan/work/append_dependencies.py && start-notebook.sh"]

注意：如果自定义脚本执行报错，后续Jupyter服务不会启动，容器依然会退出。

• 原docker-compose中volumes配置重复将三个本地路径挂载到容器内同一个/home/jovyan/work目录，后挂载的内容会覆盖之前的挂载，最终只会保留./src目录的内容，会导致notebooks等文件不可见，只保留根目录挂载即可。
• 原配置中image字段指定的jupyter/datascience-notebook:r-4.0.3和Dockerfile使用的基础镜像不一致，容易造成版本混淆，建议和实际使用的基础镜像对齐。
• 原Dockerfile中COPY . ./work末尾缺少斜杠，若容器内不存在work目录，Docker会将本地项目内容复制为名为work的单文件，导致路径错乱，正确写法为COPY . ./work/。

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