如何在Docker镜像中为同结构多.NET项目动态设置入口点dll

你遇到的报错本质是三个问题共同导致的：

1. ENTRYPOINT的exec数组格式不支持变量解析：Docker处理ENTRYPOINT ["xx", "yy"]这种写法时，会直接把数组元素当成命令和参数原样传递，不会调用shell展开$DLL_NAME这类变量。
2. 构建参数ARG的作用域仅存在于构建阶段：即使变量能被解析，容器运行时ARG已经被销毁，读取不到对应的值。
3. 你写的ENTRYPOINT ["dotnet", $DLL_NAME]不符合JSON数组语法（变量没加引号），Docker解析失败后会把整段内容当成shell命令执行，才会出现/bin/sh: [dotnet,: not found的错误。

只需要把构建参数赋值给运行时保留的环境变量，再用支持变量展开的ENTRYPOINT写法即可，修改后的Dockerfile如下：

FROM mcr.microsoft.com/dotnet/runtime:5.0-alpine3.13-amd64

# 声明构建参数，可按需设置默认值
ARG DLL_NAME
# 将构建参数值同步到环境变量，容器运行时可正常读取
ENV DLL_NAME=${DLL_NAME}

RUN echo "Building for $DLL_NAME"

WORKDIR /app
COPY . .

# 写法1：shell格式ENTRYPOINT，自动触发变量解析（推荐，写法更简洁）
ENTRYPOINT dotnet ${DLL_NAME}

# 写法2：保持exec格式，手动调用shell完成变量展开
# ENTRYPOINT ["sh", "-c", "dotnet ${DLL_NAME}"]

构建命令和你之前的用法完全一致：

docker build --build-arg "DLL_NAME=dllName.dll" -t your-image .

因为我们用了ENV存储dll名称，后续如果需要临时替换入口dll，不需要重新构建镜像，直接在运行时传入环境变量即可：

docker run -e DLL_NAME=another.dll your-image

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