Windows Server 2019构建机Docker镜像中Erlang安装异常排查

核心症状 #

基于Windows Server 2019镜像构建RabbitMQ自定义镜像时，通过静默命令安装Erlang后出现以下问题：

• 镜像构建无报错，但容器启动提示ERLANG_HOME not set correctly
• Erlang仅安装了部分文件到C:\Program Files\erl-23.2，缺失关键的bin目录
• Windows 11+Docker Desktop环境下构建的容器运行正常，但Windows Server 2019+Mirantis Container Runtime环境下异常
• 该安装逻辑3个月前可正常工作，无明确变更记录

修复方案 #

1. 显式指定Erlang安装路径 #

默认静默安装可能在不同runtime下出现路径解析错误（比如安装包自动匹配到旧版本目录），强制指定安装路径并手动配置环境变量：

# 执行Erlang静默安装，指定目标路径
RUN powershell -Command Start-Process -Wait -FilePath C:\otp_win64_23.3.exe -ArgumentList '/S', '/D=C:\Program Files\erl-23.3'

# 手动设置ERLANG_HOME和PATH
ENV ERLANG_HOME="C:\Program Files\erl-23.3"
ENV PATH="$ERLANG_HOME\bin;$PATH"

2. 以管理员权限执行安装 #

Mirantis Container Runtime在Windows Server上的默认执行上下文可能权限不足，导致安装程序无法完整写入文件，尝试添加管理员权限参数：

RUN powershell -Command Start-Process -Wait -FilePath C:\otp_win64_23.3.exe -ArgumentList '/S' -Verb RunAs

或者增强powershell命令的错误处理：

RUN powershell -Command $ErrorActionPreference='Stop'; Start-Process -FilePath "C:\otp_win64_23.3.exe" -ArgumentList "/S" -Wait -NoNewWindow -Verb RunAs

3. 改用Zip包解压替代exe安装 #

避免exe静默安装的兼容性问题，直接使用官方Zip包解压：

# 假设erl-23.3.zip已放入构建上下文
RUN Expand-Archive -Path C:\erl-23.3.zip -DestinationPath "C:\Program Files\"

ENV ERLANG_HOME="C:\Program Files\erl-23.3"
ENV PATH="$ERLANG_HOME\bin;$PATH"

4. 输出安装日志排查细节 #

在Dockerfile中添加日志记录，查看安装过程中的具体报错：

RUN powershell -Command Start-Process -Wait -FilePath C:\otp_win64_23.3.exe -ArgumentList '/S', '/L*V', 'C:\erlang_install.log'; Get-Content C:\erlang_install.log

构建时查看日志内容，确认是否存在文件写入失败、权限不足或版本冲突等信息。

5. 更新Windows Server 2019基础镜像 #

系统补丁可能影响静默安装行为，使用最新的基础镜像并安装更新：

FROM mcr.microsoft.com/windows/servercore:ltsc2019
RUN powershell -Command Get-WindowsUpdate -AcceptAll -Install -AutoReboot

（注：安装更新后需确保容器能正常重启，部分更新可能需要额外处理）

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