Windows Docker容器中OCCT.NET DLL加载失败问题求助

以下是针对问题的具体排查与解决步骤：

• 确认架构完全匹配
  确保OCCT的所有托管/原生DLL均为x64架构，同时.NET应用项目已设置编译目标平台为x64：
  在项目文件（.csproj）中添加或修改：

  <PropertyGroup>
    <PlatformTarget>x64</PlatformTarget>
  </PropertyGroup>
  

  Docker Windows镜像需使用x64版本（如mcr.microsoft.com/windows/servercore:ltsc2022），避免架构不兼容导致加载失败。

• 检查原生依赖链完整性
  Occt.NET.dll依赖OCCT原生DLL，这些原生库可能存在嵌套依赖（如特定版本的VC++组件或其他OCCT子模块）。执行以下操作排查：

  1. 进入运行的容器：docker exec -it <container-id> cmd
  2. 使用dumpbin工具检查依赖（需在镜像中安装Windows SDK工具，或复制Dependency Walker工具到容器）：

     dumpbin /dependents C:\app\Occt.NET.dll
     

     验证输出中所有列出的依赖DLL均存在于容器的PATH目录或应用目录下。

• 确保依赖目录在PATH环境变量中
  .NET加载非托管DLL时会优先搜索PATH环境变量中的目录。在Dockerfile中添加环境变量配置：

  ENV PATH="$PATH;C:\app\bin\Debug\net9.0"
  

  或直接将所有OCCT DLL复制到应用可执行文件的同级目录（通常是容器的工作目录C:\app），简化加载路径。

• 规范Docker镜像的文件复制逻辑
  避免手动复制文件可能导致的遗漏或权限问题，在Dockerfile中明确复制所有依赖文件：

  # 假设本地构建产物在./bin/Debug/net9.0目录
  COPY ./bin/Debug/net9.0/ C:/app/
  

  确保复制OCCT的所有原生DLL、托管DLL及配套资源文件（如OCCT的配置文件、子目录组件）。

• 启用加载日志定位深层问题
  在容器中设置.NET加载日志环境变量，生成详细的加载失败报告：

  ENV COMPlus_EnableLog=1
  ENV COMPlus_LogFile=C:\app\assembly_load_log.txt
  

  运行容器后查看C:\app\assembly_load_log.txt，日志会明确指出加载失败的具体原因（如缺失某个原生依赖、版本不匹配等）。

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