Kaniko构建的Docker镜像中Entrypoint脚本无法调用Python的问题排查

本地使用Dockerfile构建Python 3.9项目镜像正常，但通过Kaniko构建后，运行时ENTRYPOINT脚本执行到调用CMD指定的supervisord环节时出现以下错误：

/opt/project/conf/entrypoint.sh: /usr/bin/supervisord: /usr/bin/python3: bad interpreter: No such file or directory
/opt/project/conf/entrypoint.sh: line 8: /usr/bin/supervisord: Success

项目基于python:3.9-slim-bullseye（Debian Bullseye）基础镜像，默认Python路径为/usr/local/bin/python或/usr/local/bin/python3，与报错中提到的/usr/bin/python3不符，导致困惑。

排查思路 #

• 确认supervisord的解释器依赖：Debian Bullseye通过apt安装的supervisord，其脚本首行（shebang）为#!/usr/bin/python3，但python:3.9-slim-bullseye镜像中不存在系统级的/usr/bin/python3，只有官方预编译的Python位于/usr/local/bin目录下。本地构建时可能因Docker层缓存或本地环境特性掩盖了问题，而Kaniko是无宿主环境的纯容器构建，问题直接暴露。
• 验证镜像内Python路径：在Kaniko构建的镜像中执行which python3和ls -l /usr/bin/python3，确认/usr/bin/python3是否存在，以及/usr/local/bin/python3的位置是否正确。
• 检查supervisord安装方式：确认supervisord是通过apt安装的系统包，而非pip安装版本——pip安装的supervisord会自动适配当前环境的Python解释器路径。

解决方案 #

方案1：创建Python路径软链接（最简单直接） #

在Dockerfile的依赖安装步骤后，添加软链接将系统级Python路径指向实际存在的Python：

RUN ln -s /usr/local/bin/python3 /usr/bin/python3

此操作让apt安装的supervisord能找到正确的Python解释器。

方案2：改用pip安装supervisord（更可靠） #

替换apt安装的supervisord为pip安装版本，适配镜像内的Python环境：

1. 在dev/dev-requirements.txt中添加supervisor依赖
2. 从Dockerfile的apt-get install命令中移除supervisor
3. 确保pip安装步骤（pip install --no-cache-dir -r /usr/local/requirements.txt）包含该依赖

pip安装的supervisord会自动使用当前环境的/usr/local/bin/python3作为解释器，从根源避免路径不匹配问题。

方案3：修改supervisord的shebang（临时 workaround，不推荐） #

手动修改apt安装的supervisord脚本的shebang，指向正确的Python路径：

RUN sed -i 's|#!/usr/bin/python3|#!/usr/local/bin/python3|' /usr/bin/supervisord

此方案依赖supervisord的文件路径和shebang格式，后续系统包更新可能导致失效，仅适合临时应急。

额外优化：统一Python命令调用 #

在supervisord.conf中，将项目启动命令的python改为绝对路径，避免依赖PATH环境变量的顺序：

[program:project]
command=/usr/local/bin/python -m project.run --server

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