Linux环境下.NET 5.0 Docker容器部署游戏服务器时添加ONNX Runtime库的问题求助

我之前帮朋友排查过几乎一模一样的问题，核心原因其实是你复制的ONNX Runtime依赖是Windows版本的.dll，而Linux容器需要的是Linux原生的共享库（.so文件），直接复制本地构建的文件肯定行不通。下面给你一步步的解决方案：

1. 改用多阶段构建Dockerfile（最可靠的方法） #

直接用SDK镜像完成构建和发布，能确保自动拉取对应Linux平台的ONNX Runtime原生依赖，避免手动复制文件的错误。修改后的Dockerfile如下：

# 第一阶段：构建发布项目
FROM mcr.microsoft.com/dotnet/sdk:5.0 AS build
WORKDIR /src

# 复制项目文件（根据你的实际项目路径调整）
COPY *.csproj ./
RUN dotnet restore

# 复制所有代码并发布，指定Linux平台确保依赖正确
COPY . ./
RUN dotnet publish -c Release -o /app/publish --runtime linux-x64 --self-contained false

# 第二阶段：运行时镜像
FROM mcr.microsoft.com/dotnet/runtime:5.0
WORKDIR /app

# 从构建阶段复制发布后的完整文件（包含Linux版ONNX依赖）
COPY --from=build /app/publish .

EXPOSE 4296/udp
EXPOSE 4296/tcp

ENTRYPOINT ["dotnet", "./DarkRift.Server.Console.dll"]

2. 为什么之前的方法无效？ #

• 你在Windows本地构建的runtimes文件夹里，linux-x64/native下的libonnxruntime.so才是Linux需要的文件，但手动复制时大概率没把这个路径的文件放到容器里的正确位置；
• ONNX Runtime的NuGet包会根据构建平台自动适配依赖：Windows下构建默认拉取Windows版，只有在Linux SDK镜像环境下构建，才会拉取Linux原生的共享库；
• .NET运行时会自动从runtimes/{runtime-id}/native目录加载原生库，多阶段构建的发布目录已经包含了这个完整结构，不需要手动调整路径。

3. 额外排查步骤（如果还是有问题） #

• 进入容器验证依赖是否存在：运行docker exec -it <容器ID> bash，然后到工作目录执行find . -name "libonnxruntime.so"，确认文件是否存在；
• 给项目添加多平台Runtime标识（可选）：在你的.csproj里添加以下内容，确保构建时同时包含Windows和Linux平台的依赖：

<PropertyGroup>
  <RuntimeIdentifiers>win10-x64;linux-x64</RuntimeIdentifiers>
</PropertyGroup>

按照这个方法重新构建镜像，应该就能解决找不到ONNX Runtime原生库的问题了。

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