.NET 6容器部署报错：无法加载ole32.dll依赖的技术求助

问题概述 #

使用Visual Studio 2022创建.NET 6 Web API项目，通过TitaniumAS.Opc.Client.Core.Design开发OPC DA客户端代码，本地运行正常，但部署到切换为Windows目标的Docker Desktop时启动崩溃，抛出System.DllNotFoundException，提示无法加载共享库ole32.dll或其依赖项。

相关代码 #

客户端C#代码 #

TitaniumAS.Opc.Client.Bootstrap.Initialize();

Uri url = UrlBuilder.Build("Graybox.Simulator.1");

using (var server = new OpcDaServer(url))
{                
    server.Connect();

    OpcDaGroup group = server.AddGroup("MyGroup");
    group.IsActive = true;

    var definition1 = new OpcDaItemDefinition
    {
        ItemId = "numeric.random.int64",
        IsActive = true
    };
    var definition2 = new OpcDaItemDefinition
    {
        ItemId = "numeric.random.int32",
        IsActive = true
    };

    OpcDaItemDefinition[] definitions = { definition1, definition2 };
    OpcDaItemResult[] results = group.AddItems(definitions);

    foreach (OpcDaItemResult result in results)
    {
        if (result.Error.Failed)
            Console.WriteLine("Error adding items: {0}", result.Error);
    }

    while (true)
    {
        OpcDaItemValue[] values = group.Read(group.Items, OpcDaDataSource.Device);
        Console.WriteLine("Value is {0}", Convert.ToString(values[0].Value));

        Thread.Sleep(3000);
    }
}

Dockerfile #

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 5045

ENV ASPNETCORE_URLS=http://+:5045

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["OPC-DA.csproj", "./"]
RUN dotnet restore "OPC-DA.csproj"
COPY . .
WORKDIR "/src/."
RUN dotnet build "OPC-DA.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "OPC-DA.csproj" -c Release -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "OPC-DA.dll"]

错误日志 #

fail: Microsoft.AspNetCore.Server.Kestrel[13]
Connection id "0HMN2H4AOJ5LQ", Request id "0HMN2H4AOJ5LQ:00000002": An unhandled exception was thrown by the application.
System.DllNotFoundException: 无法加载共享库'ole32.dll'或其依赖项。为帮助诊断加载问题，请考虑设置LD_DEBUG环境变量：libole32.dll: 无法打开共享对象文件: 没有那个文件或目录

解决方案 #

1. 替换为Windows版本的.NET镜像 #

当前使用的mcr.microsoft.com/dotnet/aspnet:6.0默认是Linux镜像，即使Docker Desktop切换到Windows目标，容器仍运行在Linux环境中，而ole32.dll是Windows专属系统库，Linux环境下不存在。需将基础镜像替换为Windows版本：

修改后的Dockerfile示例：

# 使用Windows Nano Server的.NET 6基础镜像（兼容Windows 10/11 21H2+）
FROM mcr.microsoft.com/dotnet/aspnet:6.0-nanoserver-ltsc2022 AS base
WORKDIR /app
EXPOSE 5045

ENV ASPNETCORE_URLS=http://+:5045

# 使用对应版本的Windows SDK镜像
FROM mcr.microsoft.com/dotnet/sdk:6.0-nanoserver-ltsc2022 AS build
WORKDIR /src
COPY ["OPC-DA.csproj", "./"]
RUN dotnet restore "OPC-DA.csproj"
COPY . .
WORKDIR "/src/."
RUN dotnet build "OPC-DA.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "OPC-DA.csproj" -c Release -o /app/publish /p:UseAppHost=false

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "OPC-DA.dll"]

2. 确认Docker Desktop容器模式 #

打开Docker Desktop设置，在"General"选项卡中确保已切换到Windows容器模式，重启Docker Desktop使设置生效。

3. 镜像版本兼容性 #

选择的Windows镜像版本需与宿主机Windows版本匹配：

• 若宿主机是Windows 10/11 21H2及以上，推荐使用ltsc2022标签的镜像
• 若遇到COM组件缺失问题，可尝试切换到servercore版本的镜像（体积更大，但包含更多系统组件）

4. 网络权限配置 #

确保容器能访问目标OPC DA服务器，可使用--network host参数运行容器，或配置正确的端口映射与网络规则。

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