Docker容器运行Scala服务遇UnsatisfiedLinkError问题求助

问题背景 #

运行Scala服务时触发以下异常：

Caused by: java.lang.UnsatisfiedLinkError: C:\\Users\\ContainerAdministrator\\AppData\\Local\\Temp\\jni-mt5-17287867478131106707\\mt5_lib.dll: Can't find dependent libraries

服务依赖mt5_lib.dll，本地构建Docker镜像运行完全正常，但通过GitHub Actions构建推送到ECR后拉取运行时出现此错误，已尝试安装VC Redist但未解决。

可行解决方案 #

1. 确保VC Redist安装完整且版本匹配 #

GitHub Actions构建时可能存在VC Redist安装不彻底的情况，修改Dockerfile中的安装步骤，添加安装结果验证：

RUN Invoke-WebRequest -Uri "https://aka.ms/vs/17/release/vc_redist.x64.exe" -OutFile "c:\\vc_redist.x64.exe"
RUN $process = Start-Process 'c:\vc_redist.x64.exe' '/install /norestart /quiet' -PassThru; $process.WaitForExit(); if ($process.ExitCode -ne 0) { throw "VC Redist安装失败，退出码：$($process.ExitCode)" }

同时确认本地使用的VC Redist版本与CI环境一致，若mt5_lib.dll依赖旧版本VC运行时（如VS2019），可替换为对应版本的安装包。

2. 检查mt5_lib.dll的依赖项 #

在Dockerfile中添加步骤，使用dumpbin工具分析DLL依赖，确认是否存在其他缺失的系统库：

# 安装Windows SDK工具
RUN Invoke-WebRequest -Uri "https://download.microsoft.com/download/1/1/6/116E7876-7F10-4C77-9AA9-024D28A85990/windowssdk/winsdksetup.exe" -OutFile "c:\winsdksetup.exe"
RUN Start-Process 'c:\winsdksetup.exe' '/quiet /features OptionId.WindowsDesktopSoftwareDevelopmentKit' -PassThru | Wait-Process

# 分析DLL依赖（替换为实际DLL路径）
RUN & 'C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64\dumpbin.exe' /dependents 'c:\app\lib\mt5_lib.dll'

构建镜像时查看输出，对比本地构建的依赖列表，找出缺失的DLL并补充。

3. 验证DLL文件的完整性 #

在Dockerfile中添加哈希校验步骤，确认CI构建的镜像中mt5_lib.dll与本地文件一致：

RUN Get-FileHash 'c:\app\lib\mt5_lib.dll' -Algorithm SHA256 | Format-List

对比本地和CI构建的哈希值，若不一致，说明文件在CI构建过程中被损坏或替换，需检查代码复制步骤。

4. 禁用Docker构建缓存 #

GitHub Actions可能复用旧的镜像层，导致VC Redist未重新安装。修改GitHub Actions的build步骤，添加--no-cache参数：

docker build --no-cache -t "$Env:ECR_REGISTRY/$Env:ECR_REPOSITORY`:app-$Env:GITHUB_SHA" -f app\\Dockerfile .
docker push "$Env:ECR_REGISTRY/$Env:ECR_REPOSITORY`:app-$Env:GITHUB_SHA"

5. 使用Chocolatey安装VC Redist #

改用Chocolatey包管理器安装VC运行时，稳定性更高：

# 安装Chocolatey
RUN Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
# 安装VC 2015-2022运行时
RUN choco install vcredist140 -y --no-progress

6. 手动配置VC运行时路径 #

确保容器的PATH环境变量包含VC运行时的DLL目录：

# 替换为实际VC安装路径
RUN $vcPath = 'C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Redist\MSVC\14.34.31931\x64\Microsoft.VC143.CRT'
RUN $env:PATH += ";$vcPath"
ENV PATH="$vcPath;${PATH}"

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