AWS Lambda中无法加载libvips原生库，该如何解决？

看起来你遇到的核心问题有两个：一是Gradle打包时原生库没有被正确部署到Lambda的/var/task/lib目录，二是Lambda的原生库加载路径配置需要调整。我来一步步帮你解决：

1. 先确认Gradle打包的Zip结构是否正确 #

你的Gradle任务里，from('.') { include 'lib/**' } 是把项目根目录下的lib文件夹直接放到Zip的根目录，而into('lib') { from configurations.runtime } 是把Java依赖放到Zip的lib目录。这会导致一个问题：原生库和Java依赖虽然都在Zip的lib目录，但可能因为Gradle的任务顺序或路径匹配问题，原生库没有被正确包含进去。

修正你的Gradle任务，确保原生库和Java依赖都被打包到同一个lib文件夹：

task buildZip(type: Zip) {
    archiveName = "${project.name}.zip"
    // 将编译后的class文件和资源文件放到Zip根目录（Lambda要求class文件在/var/task下）
    from compileJava
    from processResources
    // 把项目根下lib文件夹里的所有原生库（.so文件）打包到Zip的lib目录
    into('lib') {
        from fileTree('lib') { include '**/*.so' }
    }
    // 把Java依赖Jar包也打包到Zip的lib目录
    into('lib') {
        from configurations.runtime
    }
    // 如果bin文件夹有需要的内容，也打包到Zip根目录
    from('.') {
        include 'bin/**'
    }
}

运行gradle buildZip后，解压生成的Zip包，检查lib文件夹里是否同时存在libvips.so和Java Jar包。如果有，说明打包是正确的。

2. 调整Lambda的原生库加载路径 #

AWS Lambda的默认LD_LIBRARY_PATH不包含/var/task/lib，所以即使你的库在这个路径下，系统也找不到它（以及它的依赖库）。你需要做两件事：

（1）设置Lambda环境变量 #

在Lambda函数的配置中，添加环境变量：

• 键：LD_LIBRARY_PATH
• 值：/var/task/lib:/usr/lib64
  这样系统会优先从你的lib目录加载原生库，再找系统默认路径。

（2）正确加载库 #

不要用绝对路径加载，而是用Java的System.loadLibrary方法，它会自动从java.library.path或LD_LIBRARY_PATH指定的路径中查找库：

System.loadLibrary("vips"); // 注意这里写"vips"，不是"libvips.so"

如果一定要用Native.loadLibrary，确保路径正确，并且已经设置了LD_LIBRARY_PATH：

Native.loadLibrary("/var/task/lib/libvips.so", Object.class);

3. 验证libvips的依赖完整性 #

libvips依赖很多系统库（比如libglib-2.0.so、libgobject-2.0.so等），如果这些库在Lambda的运行环境中不存在，即使你打包了libvips.so，还是会加载失败。

你可以在Amazon Linux 2环境（Lambda的运行系统）中用ldd libvips.so命令查看依赖，把缺失的库也打包到你的lib文件夹里。确保所有依赖库都是针对Amazon Linux 2编译的，否则会出现兼容性问题。

4. 排查部署后的路径 #

如果还是有问题，你可以在Lambda函数中添加一段代码，打印/var/task/lib目录下的所有文件，确认原生库是否存在：

File libDir = new File("/var/task/lib");
if (libDir.exists()) {
    for (File file : libDir.listFiles()) {
        System.out.println("Lib file: " + file.getName());
    }
} else {
    System.out.println("/var/task/lib does not exist");
}

查看Lambda的日志，就能知道原生库是否被正确部署到了目标路径。

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