ASP.NET Core Web API Linux Docker容器中VOSK库加载失败求助

VOSK完全支持Linux环境，你碰到的System.DllNotFoundException错误，是因为Linux容器里缺少VOSK所需的共享库文件，并非VOSK只支持Windows。

问题根源 #

Windows容器使用的是VOSK的Windows动态库（如vosk.dll），但Linux系统需要对应的Linux版本共享库libvosk.so，同时还依赖一些系统级的音频处理库，默认的.NET ASP.NET镜像里没有预装这些组件，导致运行时找不到库文件。

解决步骤 #

1. 给基础镜像安装系统依赖 #

修改base阶段的镜像，添加必要的系统库：

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443
# 安装VOSK依赖的系统库
RUN apt-get update && apt-get install -y --no-install-recommends \
    libasound2 \
    libgomp1 \
    && rm -rf /var/lib/apt/lists/*

2. 确保容器中有libvosk.so文件 #

有两种可靠的方式获取该库：

• 方式一：项目内置库文件
  将Linux版本的libvosk.so放入项目目录，设置其属性为“复制到输出目录”（始终复制），这样发布时会自动拷贝到/app/publish目录，最终镜像中就能直接使用。

• 方式二：在Dockerfile中下载官方库
  在final阶段添加下载步骤（替换为你需要的VOSK版本）：

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
# 下载并解压VOSK Linux库
RUN wget https://github.com/alphacep/vosk-api/releases/download/v0.3.45/vosk-linux-x86_64-0.3.45.zip \
    && unzip vosk-linux-x86_64-0.3.45.zip \
    && cp vosk-linux-x86_64-0.3.45/libvosk.so /app/ \
    && rm -rf vosk-linux-x86_64-0.3.45.zip vosk-linux-x86_64-0.3.45
ENTRYPOINT ["dotnet", "TestAPI.dll"]

3. 验证库路径（可选） #

如果libvosk.so不在应用根目录，可通过设置环境变量指定库路径：

ENV LD_LIBRARY_PATH=/path/to/libs:$LD_LIBRARY_PATH

额外提示 #

• 确保使用的Vosk NuGet包支持多平台，官方包已包含跨平台支持，但发布时要注意不要遗漏对应平台的库。
• 如果是ARM架构的Linux容器（比如ARM64），要下载对应架构的VOSK库，不能用x86_64版本。

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