Docker环境变量无法通过docker run覆盖的问题排查

首先，这种情况大概率是脚本里变量的赋值方式不对，或者是docker run的命令写错了——这俩是最容易踩的坑，我帮你一步步捋清楚：

第一坑：脚本硬编码默认值，堵死了外部覆盖的路径 #

很多人写entrypoint脚本时会直接这么写：

#!/bin/sh
# 错误写法！硬编码会直接覆盖外部传入的变量
MEMORY_LIMIT="512MB"
echo "内存限制是 $MEMORY_LIMIT"

不管你docker run传啥环境变量，脚本里都直接把MEMORY_LIMIT钉死成512MB，外部变量根本插不进来。

正确的写法应该用默认值语法，意思是「如果这个变量没被外部设置，就用默认值」：

#!/bin/sh
# 正确写法：只有MEMORY_LIMIT未定义时才用默认的512MB
MEMORY_LIMIT=${MEMORY_LIMIT:-512MB}
echo "内存限制是 $MEMORY_LIMIT"

第二坑：docker run的命令参数写错了 #

你是不是把环境变量写成了镜像名后面的命令参数？比如：

# 错误！这不是设置环境变量，是给entrypoint传命令行参数
docker run my-image MEMORY_LIMIT=1GB

正确的姿势是用-e参数来传递环境变量：

# 正确：用-e指定要设置的环境变量
docker run -e MEMORY_LIMIT=1GB my-image

第三坑：变量名拼写/大小写出错 #

Docker的环境变量是大小写敏感的！比如你脚本里用的是MEMORY_LIMIT，但docker run里写成了memory_limit，那肯定不会生效——仔细核对变量名的拼写和大小写。

额外排查：先确认容器里能读到环境变量 #

如果上面的都改了还是不行，先进入容器手动验证环境变量是否存在：

# 启动容器进入shell，跳过entrypoint直接调试
docker run -it -e MEMORY_LIMIT=1GB my-image sh
# 然后在容器里执行
echo $MEMORY_LIMIT

如果这里能输出1GB，说明环境变量已经传进去了，问题肯定在你的entrypoint脚本里；如果输出空，那就是docker run的命令或者Dockerfile的配置有问题。

给你一套能跑通的示例 #

Dockerfile #

FROM alpine:latest
COPY entrypoint.sh /entrypoint.sh
# 给脚本加执行权限，避免踩权限坑
RUN chmod +x /entrypoint.sh
# 这里可以设默认环境变量，会被docker run -e覆盖
ENV MEMORY_LIMIT=512MB
ENTRYPOINT ["/entrypoint.sh"]

entrypoint.sh #

#!/bin/sh
# 用默认值语法兼容外部传参
MEMORY_LIMIT=${MEMORY_LIMIT:-512MB}
echo "当前内存限制：$MEMORY_LIMIT"

运行命令 #

docker run -e MEMORY_LIMIT=1GB my-image

这时候应该会输出当前内存限制：1GB，完美覆盖默认值。

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