Windows Docker容器执行EXE时出现退出码3221225781问题排查

这个退出码我太熟悉了——3221225781对应Windows错误代码0xC0000135，也就是STATUS_DLL_NOT_FOUND，你的推测完全正确：程序运行时找不到必需的依赖DLL文件。下面是针对性的解决步骤：

首先得搞清楚你的myprogram.exe到底缺了哪些库：

• 用Windows自带的dumpbin工具（需要安装Visual Studio或Windows SDK）在宿主机上执行：

  dumpbin /dependents mydir/myprogram.exe
  

  这个命令会列出程序所有直接依赖的DLL文件。
• 如果你没有安装VS/SDK，也可以用Dependency Walker这类工具（注意它对Win10+的兼容性，可能会误报一些系统DLL，但核心依赖还是能准确识别）。

microsoft/windowsservercore是一个极简的Windows Server核心镜像，很多常用运行时（比如.NET Framework、VC++ Redistributable）都没有预装。根据你的程序依赖选对基础镜像能省很多事：

• 如果程序依赖.NET Framework 4.8，直接用mcr.microsoft.com/dotnet/framework/runtime:4.8-windowsservercore-ltsc2019作为基础镜像；
• 如果依赖VC++运行库，优先选择自带对应版本运行时的镜像，或者在基础镜像里手动安装。

如果必须坚持用windowsservercore，可以通过两种方式补充依赖：

方式一：直接拷贝缺失的DLL #

把程序需要的DLL和exe一起拷贝到容器里，确保路径正确（一般和exe同目录即可）：

FROM microsoft/windowsservercore
COPY mydir/myprogram.exe /mydir/
# 把缺失的DLL文件也拷贝到容器的对应目录
COPY mydir/missing_dll1.dll /mydir/
COPY mydir/missing_dll2.dll /mydir/
CMD ["/mydir/myprogram.exe","someparameter"]

方式二：安装运行时包 #

如果依赖的是VC++这类通用运行时，可以在容器里直接安装对应的安装包：

FROM microsoft/windowsservercore
# 下载并静默安装VC++ 2019 x64运行时（根据你的程序需求调整版本）
RUN powershell -Command \
    Invoke-WebRequest -Uri https://aka.ms/vs/17/release/vc_redist.x64.exe -OutFile vc_redist.exe ; \
    Start-Process .\vc_redist.exe -ArgumentList '/quiet /norestart' -Wait ; \
    Remove-Item vc_redist.exe -Force

COPY mydir/myprogram.exe /mydir/
CMD ["/mydir/myprogram.exe","someparameter"]

如果还是不确定哪里出问题，可以启动容器进入交互式命令行，手动运行程序看具体错误提示：

docker run -it --entrypoint cmd myimage

进入容器后，切换到程序目录手动执行：

cd /mydir
myprogram.exe someparameter

这时会弹出Windows的错误窗口，明确告诉你缺失哪个DLL，比只看退出码更直观。

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