Docker环境下.NET插件式应用引用非重分发第三方DLL的加载方案

针对你遇到的Docker场景下插件无法加载独立目录中第三方DLL的问题，以下是几种可行的解决方案：

方案1：为插件的AssemblyLoadContext添加自定义解析逻辑 #

在主应用加载插件的代码中，为插件专属的AssemblyLoadContext注册程序集解析回调，指定第三方DLL的搜索路径：

// 创建插件独立的AssemblyLoadContext
var pluginALC = new AssemblyLoadContext("PluginSpecificContext", isCollectible: true);

// 添加程序集解析逻辑，优先从data/lib目录查找
pluginALC.Resolving += (alc, assemblyName) =>
{
    var targetPath = Path.Combine(Path.GetFullPath("/app/data/lib"), $"{assemblyName.Name}.dll");
    return File.Exists(targetPath) ? alc.LoadFromAssemblyPath(targetPath) : null;
};

// 加载插件程序集
var pluginAssembly = pluginALC.LoadFromAssemblyPath("/app/plugins/YourPlugin.dll");

当插件尝试加载Some3rdParty.dll时，会触发这个回调，从指定的挂载目录中加载DLL。

方案2：在插件项目中配置运行时探测路径 #

修改插件的.csproj文件，添加运行时探测目录配置，让插件加载时自动搜索指定路径：

<PropertyGroup>
  <!-- 根据实际需要添加运行时标识符 -->
  <RuntimeIdentifiers>linux-x64;win-x64</RuntimeIdentifiers>
</PropertyGroup>

<ItemGroup>
  <!-- 配置原生DLL和托管DLL的搜索目录 -->
  <RuntimeHostConfigurationOption Include="NATIVE_DLL_SEARCH_DIRECTORIES" Value="$(AppDir)/data/lib" />
  <RuntimeHostConfigurationOption Include="PROBING_DIRECTORIES" Value="$(AppDir)/data/lib" />
</ItemGroup>

容器中如果将用户的data目录挂载到/app/data，$(AppDir)会自动指向应用根目录，插件加载时会去/app/data/lib查找依赖DLL。

方案3：通过环境变量指定全局程序集搜索路径 #

在启动Docker容器时，设置DOTNET_ADDITIONAL_DEPS环境变量，将第三方DLL所在目录纳入.NET运行时的搜索范围：

docker run -v /host/user-data:/app/data -e DOTNET_ADDITIONAL_DEPS=/app/data/lib your-plugin-app-image

这个环境变量会让.NET运行时自动扫描指定目录下的程序集，插件加载时就能找到目标DLL。

关键注意点 #

• 确保容器中挂载的data目录权限正确，应用进程拥有读取该目录及DLL文件的权限。
• 第三方DLL的版本必须与插件编译时引用的版本完全一致，避免版本不兼容导致的加载异常。
• 严格遵守第三方DLL的许可协议，Docker镜像中不要包含该DLL，仅保留目录结构，由用户自行挂载包含合法授权DLL的目录。

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