在C#应用中调用C共享库时如何引入系统依赖库zlib

问题原因 #

你尝试用<Reference>标签在csproj中引入非托管的libz.so.1是错误的——这个标签仅适用于.NET托管程序集（带CLR元数据的.dll/.exe文件），非托管共享库无法被.NET的引用系统识别，因此会抛出BadImageFormatException。

非托管库的加载由系统动态链接器（ld-linux）负责，而非.NET框架，所以不需要在csproj中添加引用，只需确保动态链接器能找到依赖的库即可。

可行解决方案 #

1. 确保libXXX.so已正确链接zlib #

首先检查你的libXXX.so是否已正确关联zlib：

ldd libXXX.so

如果输出包含libz.so.1 => /lib/x86_64-linux-gnu/libz.so.1，说明链接正常。如果没有，需要重新编译libXXX.so，编译时加上-lz参数链接zlib，这样动态链接器加载libXXX.so时会自动加载其依赖的zlib。

2. 配置LD_LIBRARY_PATH环境变量 #

如果zlib所在目录不在系统默认库搜索路径中（Debian10中/lib/x86_64-linux-gnu是默认路径，一般无需额外设置，若zlib在其他位置则需配置），可通过LD_LIBRARY_PATH让动态链接器找到它：

临时启动设置

启动程序前执行：

export LD_LIBRARY_PATH=/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH
dotnet run

嵌入到csproj中（推荐）

在项目的.csproj文件中添加如下配置，让dotnet run或发布后的程序自动带上环境变量：

<PropertyGroup>
  <RunEnvironmentVariables>LD_LIBRARY_PATH=/lib/x86_64-linux-gnu:%LD_LIBRARY_PATH%</RunEnvironmentVariables>
</PropertyGroup>

3. 将zlib复制到程序输出目录 #

把libz.so.1复制到C#项目的输出目录（比如bin/Debug/net6.0），动态链接器会优先从当前工作目录加载库，无需修改环境变量。

4. 显式加载zlib（备选） #

如果上述方法都不生效，可在C#代码中显式调用系统的dlopen加载zlib，确保它在libXXX.so之前被加载：

using System.Runtime.InteropServices;

public class CS_XXX {
    static CS_XXX()
    {
        // 显式加载zlib
        IntPtr zlibHandle = LoadLibrary("/lib/x86_64-linux-gnu/libz.so.1");
        if (zlibHandle == IntPtr.Zero)
        {
            throw new System.Exception("Failed to load zlib");
        }
    }

    [DllImport("libdl.so")]
    private static extern IntPtr LoadLibrary(string filename);

    // 你的其他代码...
}

注意 #

LD_PRELOAD是强制预加载库的方式，一般用于调试或替换系统库，不推荐作为生产环境方案，上述方法更符合非托管库加载的常规逻辑。

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