如何解决Dockerfile中通过if语句修改ARG值的报错问题

错误原因分析 #

你遇到的/bin/sh: 1: =sampleValue1: not found错误，本质有两个核心问题：

1. shell赋值语法错误：shell中变量赋值的正确写法是var=value，左边不能用${var}的形式。你写了${sampleArgTwo}="sampleValue1"，而sampleArgTwo初始未设置（为空），shell会把=sampleValue1当成命令执行，自然找不到这个命令。
2. ARG与shell变量的混淆：Docker的ARG是构建阶段的全局参数，而RUN指令里的shell变量是临时进程内变量——即便修正了赋值语法，在RUN里给shell变量sampleArgTwo赋值，也不会改变Docker的ARG sampleArgTwo的值，后续Docker指令无法使用这个修改后的值。

解决方案 #

场景1：需要在整个构建阶段使用条件化的ARG值 #

如果希望sampleArgTwo作为Docker构建参数，在后续COPY、RUN等指令中都能使用，直接在ARG指令中用shell命令替换实现条件赋值：

# ABC是基于Ubuntu的Docker镜像
FROM ABC 

# sampleArgOne为构建参数，可设置不同值
ARG sampleArgOne="1.2.3"

# 根据sampleArgOne的值条件设置sampleArgTwo的默认值
ARG sampleArgTwo=$([ "${sampleArgOne}" = "1.2.3" ] && echo "sampleValue1" || [ "${sampleArgOne}" = "5.6.7" ] && echo "sampleValue2" || echo "")

# 验证参数（可选）
RUN echo "sampleArgOne: ${sampleArgOne}, sampleArgTwo: ${sampleArgTwo}"

这种方式直接通过Docker的ARG语法完成条件赋值，sampleArgTwo会作为构建参数存在，后续所有指令都能直接引用它。

场景2：仅在当前RUN的shell环境中使用变量 #

如果只是在当前RUN指令的shell进程中需要这个变量，修正赋值语法即可，同时注意Dockerfile的换行转义（用\连接多行命令）：

# ABC是基于Ubuntu的Docker镜像
FROM ABC 

ARG sampleArgOne="1.2.3"

RUN if [ "${sampleArgOne}" = "1.2.3" ]; \
    then \
        sampleArgTwo="sampleValue1"; \
    elif [ "${sampleArgOne}" = "5.6.7" ]; \
    then \
        sampleArgTwo="sampleValue2"; \
    fi; \
    echo "当前shell中的sampleArgTwo: ${sampleArgTwo}"

注意：这里的sampleArgTwo只是当前RUN进程的临时变量，后续的RUN指令无法直接访问它。

场景3：需要在容器运行时保留这个变量 #

如果希望容器启动后也能使用这个变量，需要将其设置为环境变量（用ENV）：

# ABC是基于Ubuntu的Docker镜像
FROM ABC 

ARG sampleArgOne="1.2.3"

# 先将条件值写入临时文件
RUN if [ "${sampleArgOne}" = "1.2.3" ]; \
    then \
        echo "sampleValue1" > /tmp/arg_val; \
    elif [ "${sampleArgOne}" = "5.6.7" ]; \
    then \
        echo "sampleValue2" > /tmp/arg_val; \
    fi

# 读取临时文件内容设置ARG，再转为环境变量
ARG sampleArgTwo=$(cat /tmp/arg_val)
ENV sampleArgTwo=${sampleArgTwo}

# 验证环境变量（可选）
RUN echo "容器环境变量sampleArgTwo: ${sampleArgTwo}"

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