构建Windows容器时运行PowerShell脚本遇意外EOF错误求助

环境配置 #

Dockerfile #

# syntax=docker/dockerfile:1

FROM mcr.microsoft.com/windows:ltsc2019

# buildtools for msvc
# rustup-init for rust installation

SHELL ["powershell", "-executionpolicy remotesigned"]
COPY vs_BuildTools.exe C:\\
COPY rustup-init.exe C:\\
COPY setup.ps1 C:\\


RUN .\setup.ps1


RUN ["C:\\rustup-init.exe", "-y", "-v"]

PowerShell安装脚本（setup.ps1） #

# Powershell Script to install build tools 
# Waits for the installation to complete before exiting

Function install-tools {
    # Install Visual Studio Build Tools
    $vs_bt = "C:\vs_BuildTools.exe"
    Start-Process -FilePath $vs_bt -ArgumentList @("--quiet", "--wait", "--norestart", "--nocache",
    "--installPath C:\BuildTools", "--add Microsoft.Component.MSBuild","--add Microsoft.VisualStudio.Component.Windows10SDK.18362",
    "--add Microsoft.VisualStudio.Component.VC.Tools.x86.x64")
    
    $Directory = "C:\BuildTools\Common7\Tools\"
    # wait for vs_buildtools.exe too finish
    while(-Not (Test-Path -Path $Directory)) {}
    Write-Output "Done!"
}

install-tools

构建错误日志 #

PS C:\Users\----\Documents\winrust_img> docker build --network="Default Switch" . -t wr:testing
Sending build context to Docker daemon  12.96MB
Step 1/7 : FROM mcr.microsoft.com/windows:ltsc2019
 ---> 237fdc0df058
Step 2/7 : SHELL ["powershell", "-executionpolicy remotesigned"]
 ---> Running in 47315eabc649
 ---> Removed intermediate container 47315eabc649
 ---> 607f3135c493
Step 3/7 : COPY vs_BuildTools.exe C:\\
 ---> 4681ba90244e
Step 4/7 : COPY rustup-init.exe C:\\
 ---> aad23faa87a0
Step 5/7 : COPY setup.ps1 C:\\
 ---> 1c71d8abc326
Step 6/7 : RUN .\setup.ps1
 ---> Running in 9a26c3d1bb42
Done!
unexpected EOF

问题根源 #

核心问题在于PowerShell脚本提前退出，而后台的VS Build Tools安装进程仍在运行，导致Docker在捕获容器输出流时意外中断，触发Unexpected EOF错误。原脚本仅通过检测目录是否存在判断安装完成，但该目录会在安装初期就被创建，远早于实际安装结束，脚本因此提前结束，而此时安装进程仍占用输出流，Docker读取流时出现异常。

解决方案 #

1. 修改PowerShell脚本，确保等待安装进程完全结束 #

修改setup.ps1，使用Start-Process的-Wait和-PassThru参数跟踪安装进程，等待其真正退出，并验证关键文件生成：

# Powershell Script to install build tools 
# Waits for the installation to complete before exiting

Function install-tools {
    # Install Visual Studio Build Tools
    $vs_bt = "C:\vs_BuildTools.exe"
    # 启动安装进程并等待其退出，捕获进程对象
    $installProcess = Start-Process -FilePath $vs_bt -ArgumentList @(
        "--quiet", "--wait", "--norestart", "--nocache",
        "--installPath C:\BuildTools",
        "--add Microsoft.Component.MSBuild",
        "--add Microsoft.VisualStudio.Component.Windows10SDK.18362",
        "--add Microsoft.VisualStudio.Component.VC.Tools.x86.x64"
    ) -Wait -PassThru -NoNewWindow

    # 检查安装进程退出码，非0则抛出错误并终止脚本
    if ($installProcess.ExitCode -ne 0) {
        Write-Error "VS Build Tools安装失败，退出码: $($installProcess.ExitCode)"
        exit $installProcess.ExitCode
    }

    # 验证关键组件文件存在（比检测目录更可靠）
    $msbuildPath = "C:\BuildTools\MSBuild\Current\Bin\MSBuild.exe"
    while (-Not (Test-Path -Path $msbuildPath)) {
        Start-Sleep -Seconds 3
        Write-Output "等待MSBuild组件生成..."
    }

    Write-Output "VS Build Tools安装完成!"
}

install-tools

2. 优化Dockerfile的SHELL和RUN指令 #

调整SHELL参数，添加-NoProfile避免加载不必要的用户配置，同时明确脚本执行路径：

# syntax=docker/dockerfile:1

FROM mcr.microsoft.com/windows:ltsc2019

# buildtools for msvc
# rustup-init for rust installation

# 优化PowerShell执行参数，避免加载配置文件
SHELL ["powershell", "-NoProfile", "-ExecutionPolicy", "RemoteSigned"]
COPY vs_BuildTools.exe C:\
COPY rustup-init.exe C:\
COPY setup.ps1 C:\

# 明确执行脚本的绝对路径
RUN C:\setup.ps1

RUN ["C:\\rustup-init.exe", "-y", "-v"]

3. 额外验证项 #

• 确保所有脚本文件（setup.ps1）的换行符为Windows格式（CRLF），编码为UTF-8 with BOM或Windows-1252，避免PowerShell读取异常。
• 构建时保持网络稳定，VS Build Tools安装需要下载组件，确保容器能正常访问外网。

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