Linux下.NET项目如何链接系统安装的原生库？

针对迁移后遇到的System.DllNotFoundException问题，以下几种.csproj配置方法可以让程序直接使用Debian系统标准路径下的原生库，无需复制库文件或使用NuGet：

1. 确保DllImport的库名匹配系统符号链接 #

Linux系统的原生库通常会生成不带版本号的符号链接（比如libglib-2.0.so指向实际的libglib-2.0.so.0），检查代码中[DllImport]的参数是否使用了正确的无版本库名：

// 正确写法，让系统动态链接器自动解析版本
[DllImport("libglib-2.0.so")]
private static extern void SomeGlibFunction();

如果写了带版本号的全名（如libglib-2.0.so.0），可能会因为系统库版本更新导致找不到，优先使用无版本的符号链接名称。

2. 通过运行时配置添加系统库搜索路径 #

在项目的.csproj文件中添加<RuntimeHostConfigurationOption>，将Debian的系统标准库路径加入.NET的原生库搜索目录：

<PropertyGroup>
  <!-- 合并系统默认LD_LIBRARY_PATH和标准库路径 -->
  <RuntimeHostConfigurationOption Include="NATIVE_DLL_SEARCH_DIRECTORIES" Value="$([System.Environment]::GetEnvironmentVariable('LD_LIBRARY_PATH')):/usr/lib/x86_64-linux-gnu" />
</PropertyGroup>

这个配置会让.NET运行时在搜索原生库时，同时检查系统标准路径/usr/lib/x86_64-linux-gnu，和系统默认的动态链接器路径保持一致。

3. 使用DllMap映射特定库（兼容Mono迁移项目） #

如果是从Mono迁移的项目，可以沿用Mono的dllmap机制，直接映射库到系统路径：

1. 在项目根目录创建dllmap.xml文件，内容示例：

<configuration>
  <dllmap dll="glib-2.0" target="/usr/lib/x86_64-linux-gnu/libglib-2.0.so.0" />
  <!-- 可添加多个库的映射规则 -->
</configuration>

2. 在.csproj中配置将该文件复制到输出目录，并启用运行时配置：

<ItemGroup>
  <None Include="dllmap.xml">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>
<PropertyGroup>
  <MonoRuntimeOptions>--config dllmap.xml</MonoRuntimeOptions>
</PropertyGroup>

这种方式适合需要对多个原生库做精准路径映射的场景，保持和Mono时期的配置习惯一致。

以上方法均无需复制系统库到项目输出目录，直接使用Debian发行版维护的系统库，符合正式环境的要求。

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