ML.NET加载onnxruntime.dll报错0x8007045A，寻求调试方案

问题背景 #

在.NET 8.0控制台程序中使用Microsoft.ML 4.0.2调用ONNX模型时，出现跨机器运行不一致问题：一台机器正常执行，另一台抛出DllNotFoundException，错误码为0x8007045A。已确认onnxruntime.dll（版本1.22.25.627）已复制到输出目录且被加载，通过Process Monitor未检测到明显的DLL缺失情况。

报错信息 #

Unable to load DLL 'onnxruntime' or one of its dependencies: A dynamic link library (DLL) initialization routine failed. (0x8007045A)
    Exception type: DllNotFoundException
    Stack trace:    at Microsoft.ML.OnnxRuntime.NativeMethods.OrtGetApiBase()
   at Microsoft.ML.OnnxRuntime.NativeMethods..cctor()

内部异常详情：

Inner Exception: Unable to load DLL 'onnxruntime' or one of its dependencies: A dynamic link library (DLL) initialization routine failed. (0x8007045A)
    Exception type: DllNotFoundException
    Stack trace:    at Microsoft.ML.OnnxRuntime.NativeMethods.OrtGetApiBase()
   at Microsoft.ML.OnnxRuntime.NativeMethods..cctor()

复现代码 #

using Microsoft.ML;
using Microsoft.ML.Data;

internal class Program
{
    static void Main(string[] args)
    {
        string modelPath = "my_model.onnx";

        try{
            var mlContext = new MLContext(seed: 1);

            // 此行抛出异常
            var estimator = mlContext.Transforms.ApplyOnnxModel(modelPath);
        }
        catch(Exception ex){
            Console.WriteLine($"Exception occurred: {ex.Message}");
            Console.WriteLine($"Exception type: {ex.GetType().Name}");
            Console.WriteLine($"Stack trace: {ex.StackTrace}");

            if (ex is TypeInitializationException fTex)
            {
                 ex = fTex.InnerException;

                 if (ex is not null)
                 {
                     Console.WriteLine();
                     Console.WriteLine($"    Inner Exception: {ex.Message}");
                     Console.WriteLine($"    Exception type: {ex.GetType().Name}");
                     Console.WriteLine($"    Stack trace: {ex.StackTrace}");
                 }
             }
        }
    }
}

调试定位方法 #

• 核对版本兼容性：确认Microsoft.ML 4.0.2与onnxruntime.dll版本匹配，检查NuGet依赖树是否存在版本冲突。可直接安装指定版本的Microsoft.ML.OnnxRuntime包，替代间接引入的依赖，确保版本一致。
• 用Dependency Walker分析依赖：将目标机器上的onnxruntime.dll拖入Dependency Walker工具，检查是否存在缺失、版本不兼容的依赖DLL（如VC++运行时、CUDA组件等）。注意程序架构（x64/x86）必须与DLL一致。
• 启用ONNX Runtime详细日志：在代码中添加日志配置，捕获加载过程的细节信息：

  var sessionOptions = new Microsoft.ML.OnnxRuntime.SessionOptions();
  sessionOptions.LogSeverityLevel = Microsoft.ML.OnnxRuntime.OrtLoggingLevel.ORT_LOGGING_LEVEL_VERBOSE;
  sessionOptions.LoggingCallback = (level, category, message) => Console.WriteLine($"{level}: {category} - {message}");
  var estimator = mlContext.Transforms.ApplyOnnxModel(modelPath, options: sessionOptions);
  

  运行后查看日志，定位初始化失败的具体环节。
• 检查VC++运行时库：ONNX Runtime依赖Visual C++ Redistributable运行时，确认目标机器安装了对应版本（2019或2022版），且架构与程序匹配。若缺失，直接安装官方VC++运行时包。
• 验证CPU指令集兼容性：部分ONNX Runtime版本依赖AVX2等高级CPU指令集，若目标机器CPU不支持，会导致初始化失败。可尝试替换为兼容基础指令集的ONNX Runtime版本。
• 确认文件完整性与权限：对比两台机器上onnxruntime.dll的哈希值，确保文件未损坏；同时确认程序运行时有足够权限读取该文件，必要时重新复制DLL到输出目录。

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