Dockerfile构建Python镜像时entrypoint.sh设置环境变量不生效如何解决

你遇到的环境变量不生效问题主要由以下几个常见原因导致：

• entrypoint.sh脚本末尾无参数的exec没有实际作用，且没有将Python进程替换为当前shell的主进程，环境变量继承链路断裂
• 未校验profile变量的传入状态，如果启动容器时没有传入该变量，SETTINGS的拼接结果会不符合预期
• 部分场景下entrypoint.sh没有可执行权限，或者ENTRYPOINT配置的执行链路有额外的shell嵌套，导致export的变量作用域仅存在于子shell中

1. 修正entrypoint.sh脚本内容 #

替换为如下内容，保留变量导出逻辑，新增容错校验，同时用exec让Python进程成为主进程完整继承环境变量：

#!/bin/bash
# 校验profile变量是否传入，避免配置路径错误
if [ -z "$profile" ]; then
  echo "ERROR: 未传入profile环境变量，请检查容器启动参数"
  exit 1
fi
export SETTINGS=/acalls-service/${profile}.cfg
# 调试阶段可保留该行，确认变量拼接结果
echo "当前加载配置路径：$SETTINGS"
# 用exec替换当前shell，Python进程直接继承所有环境变量
exec python -m "_acalls_clasiffier"

2. 修正Dockerfile配置 #

确保你在Dockerfile中给entrypoint.sh授予了可执行权限，并且ENTRYPOINT配置正确：

# 复制脚本后新增执行权限配置
COPY entrypoint.sh ./
RUN chmod +x entrypoint.sh
# 直接执行脚本即可，无需额外嵌套bash调用
ENTRYPOINT ["./entrypoint.sh"]

3. 启动容器时传入profile变量 #

启动容器时必须通过环境变量传入profile值，才能正确拼接SETTINGS路径：

# 预生产环境启动示例
docker run -e profile=preprod 你的镜像名
# 生产环境启动示例
docker run -e profile=prod 你的镜像名

如果使用docker-compose，在服务的environment配置块中添加profile: preprod即可。

你可以在Python代码的入口位置添加如下代码，确认环境变量是否正常读取：

import os
print("读取到的SETTINGS值：", os.getenv("SETTINGS"))

内容的提问来源于stack exchange，提问作者Alejandro Sánchez