Containerfile中VERSION变量替换失效，dotnet publish未获变量值求助

场景说明 #

• 构建Docker容器
• 使用Alpine作为基础镜像
• Containerfile接收VERSION作为构建参数
• 将该参数设置为镜像版本
• 同时需将同一版本传入dotnet publish命令

问题描述 #

构建时传入的VERSION变量始终未被替换，dotnet publish命令接收到的是未解析的${VERSION}占位符，而非实际传入的版本值。

相关代码 #

ARG VERSION

FROM mcr.microsoft.com/dotnet/sdk:6.0-alpine as build
ARG VERSION
RUN echo ${VERSION}
RUN echo ${VERSION} > image_version
WORKDIR /app
COPY . .
RUN dotnet restore
# TODO Pass the version as build command below.
RUN dotnet publish --version-suffix ${VERSION} --output /app/published-app

已尝试方案 #

尝试过多种变量替换写法，均无效：

• "$VERSION"
• "$(VERSION)"
• $VERSION

可能的原因分析 #

1. 构建时未传递ARG参数：
   若构建镜像时未通过docker build --build-arg VERSION=你的版本号显式传入VERSION参数，Docker会将该变量视为未定义，此时shell会直接输出${VERSION}原字符串，而非替换为实际值。

2. ARG参数大小写不匹配：
   Docker的ARG变量是大小写敏感的。如果构建时传入的参数名是小写version而非大写VERSION，会导致变量无法被正确识别，进而无法替换。

3. Docker版本兼容性问题：
   部分旧版本Docker对多阶段构建中的ARG变量传递存在处理bug，导致FROM之后声明的ARG无法正确获取构建时传入的值。建议升级到较新的Docker版本再测试。

4. shell解析异常：
   Alpine镜像默认使用ash shell，虽然${VERSION}是标准的变量引用语法，但如果命令被特殊字符干扰（比如命令行中的引号嵌套错误），可能导致shell无法正确解析变量。可以尝试在RUN命令前显式指定shell，比如RUN /bin/sh -c 'dotnet publish --version-suffix ${VERSION} --output /app/published-app'。

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