Dockerfile中dotnet restore无法解析环境变量的问题排查

问题重现 #

Dockerfile配置：

ARG PACKAGE_FEED_URL
ENV PACKAGE_FEED_URL ${PACKAGE_FEED_URL}
RUN echo Feed selected: $PACKAGE_FEED_URL
...
RUN dotnet restore -s "$PACKAGE_FEED_URL" -s "https://api.nuget.org/v3/index.json" "Invoker/Invoker.Main.csproj"

echo命令能正常输出变量值：

Step 8/42 : RUN echo Feed selected: $PACKAGE_FEED_URL
 ---> Running in b6b52910f2c2
Feed selected: https://company.pkgs.visualstudio.com/_packaging/My_Artifacts/nuget/v3/index.json

但dotnet restore执行失败，日志显示命令未正确解析变量：

The command '/bin/sh -c dotnet restore -s "$PACKAGE_FEED_URL" -s "https://api.nuget.org/v3/index.json" "Invoker/Invoker.Main.csproj"' returned a non-zero code: 1

核心原因与解决方案 #

1. 直接使用ARG变量（无需转ENV） #

ARG在Docker构建阶段全程可用，而ENV是为容器运行时设置的。dotnet restore是构建阶段操作，可跳过ENV转换，直接在RUN中引用ARG：

ARG PACKAGE_FEED_URL
RUN echo Feed selected: $PACKAGE_FEED_URL
...
RUN dotnet restore -s "$PACKAGE_FEED_URL" -s "https://api.nuget.org/v3/index.json" "Invoker/Invoker.Main.csproj"

2. 检查shell解析的引号问题 #

部分场景下shell对双引号的处理可能不符合预期，尝试用显式调用shell的方式执行命令：

RUN sh -c 'dotnet restore -s "$PACKAGE_FEED_URL" -s "https://api.nuget.org/v3/index.json" "Invoker/Invoker.Main.csproj"'

3. 多阶段构建需重新声明ARG #

如果Dockerfile使用多阶段构建，ARG变量不会自动传递到后续阶段，需要在每个使用的阶段重新声明：

# 第一阶段
ARG PACKAGE_FEED_URL
RUN echo Feed selected: $PACKAGE_FEED_URL

# 第二阶段
FROM mcr.microsoft.com/dotnet/sdk:6.0
ARG PACKAGE_FEED_URL  # 重新声明ARG以传递到当前阶段
RUN dotnet restore -s "$PACKAGE_FEED_URL" -s "https://api.nuget.org/v3/index.json" "Invoker/Invoker.Main.csproj"

4. 排查URL中的特殊字符 #

若PACKAGE_FEED_URL包含&、=等特殊字符，shell可能错误拆分参数。先通过printf验证变量实际内容：

RUN printf 'Feed URL: %q\n' "$PACKAGE_FEED_URL"

若输出存在转义字符，尝试用单引号包裹变量：

RUN dotnet restore -s '$PACKAGE_FEED_URL' -s "https://api.nuget.org/v3/index.json" "Invoker/Invoker.Main.csproj"

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