Spring Boot中使用libjpeg遇依赖缺失及UnsatisfiedLinkError问题求助

你遇到的UnsatisfiedLinkError本质是TurboJPEG的本地库（.dylib/.so）未被正确加载，尤其是在Apple M2（arm64架构）和Linux跨平台场景下。以下是针对性的解决方案：

方案一：使用官方跨平台依赖（推荐） #

放弃手动下载jar包的方式，改用libjpeg-turbo官方维护的Maven依赖，它会自动根据运行平台适配加载对应的本地库，无需手动处理本地文件。

修改POM配置 #

替换原有的system scope依赖为中央仓库的官方依赖：

<dependency>
    <groupId>org.libjpeg-turbo</groupId>
    <artifactId>turbojpeg</artifactId>
    <version>2.1.5</version> <!-- 选择最新稳定版，支持arm64/x86_64多架构 -->
</dependency>

这个依赖会自动为Mac M2（arm64）、Linux x86_64/arm64等平台引入对应的本地库，彻底避免手动管理本地文件的问题。

方案二：手动适配本地库（若必须使用ome.turbojpeg） #

如果你坚持使用ome的turbojpeg包，需要确保对应平台的本地库被正确加载：

1. 准备对应架构的本地库 #

• 为Apple M2下载arm64版本的libturbojpeg.dylib
• 为Linux下载对应架构（x86_64/arm64）的libturbojpeg.so
• 将这些文件放到项目的src/main/resources目录下

2. 动态加载本地库 #

在Spring Boot启动类中添加静态代码块，根据当前操作系统和架构动态加载对应的本地库：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import java.io.File;
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.StandardCopyOption;

@SpringBootApplication
public class ImageKitApplication {

    static {
        try {
            String os = System.getProperty("os.name").toLowerCase();
            String arch = System.getProperty("os.arch").toLowerCase();
            String libName;

            // 匹配对应平台的本地库文件名
            if (os.contains("mac")) {
                libName = arch.contains("arm64") ? "libturbojpeg.dylib" : "libturbojpeg-x86_64.dylib";
            } else if (os.contains("linux")) {
                libName = arch.contains("aarch64") ? "libturbojpeg.so" : "libturbojpeg-x86_64.so";
            } else {
                throw new UnsupportedOperationException("不支持当前操作系统");
            }

            // 从resources读取本地库，写入临时文件后加载（避免路径问题）
            InputStream inputStream = ImageKitApplication.class.getClassLoader().getResourceAsStream(libName);
            File tempLib = File.createTempFile("turbojpeg", libName.substring(libName.lastIndexOf('.')));
            tempLib.deleteOnExit();
            Files.copy(inputStream, tempLib.toPath(), StandardCopyOption.REPLACE_EXISTING);
            System.load(tempLib.getAbsolutePath());
        } catch (Exception e) {
            throw new RuntimeException("加载TurboJPEG本地库失败", e);
        }
    }

    public static void main(String[] args) {
        SpringApplication.run(ImageKitApplication.class, args);
    }
}

3. 验证代码兼容性 #

你的PNG转JPEG代码中，TJ.SAMP_420的使用是正确的，确保了4:2:0的子采样格式。需要注意：

• 确保BufferedImage转换为BGR格式的逻辑正确，TurboJPEG的PF_BGR格式要求输入数据为BGR顺序的字节数组
• 压缩时的TJ.FLAG_BOTTOMUP标记符合图像数据的存储顺序，无需修改

关键注意事项 #

• 本地库版本必须与TurboJPEG的jar包版本完全匹配，否则会出现加载错误
• Mac M2平台必须使用arm64架构的本地库，不能用x86_64版本（即使通过Rosetta转译也可能报错）
• Linux环境下若使用动态链接的libturbojpeg.so，需确保系统已安装依赖库（如libc6），或使用静态编译版本

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