RocksDB 在 macOS M 系列 上运行时报错的解决方案

问题现象

项目中引入可Kafka Stream ,Windows下启动不报错 ,但是在 macOS M系列 环境下就会报错,初步定位是使用 Java 项目调用 RocksDB 时,运行过程中出现以下报错:

  • UnsatisfiedLinkError: no rocksdbjni in java.library.path
  • 或者 librocksdbjni.dylib 无法被正确加载。
java 复制代码
Exception in thread "kafka-streams-app001-f566769f-d99b-45fa-9a5a-5ebf722fd601-StreamThread-1" java.lang.UnsatisfiedLinkError: Can't load library: /var/folders/qj/l1h4j0mj0bs56qd20d4sr3_40000gn/T/librocksdbjni13358465134412954828.jnilib
	at java.base/java.lang.ClassLoader.loadLibrary(ClassLoader.java:2622)
	at java.base/java.lang.Runtime.load0(Runtime.java:765)
	at java.base/java.lang.System.load(System.java:1852)
	at org.rocksdb.NativeLibraryLoader.loadLibraryFromJar(NativeLibraryLoader.java:78)
	at org.rocksdb.NativeLibraryLoader.loadLibrary(NativeLibraryLoader.java:56)
	at org.rocksdb.RocksDB.loadLibrary(RocksDB.java:64)
	at org.rocksdb.RocksDB.<clinit>(RocksDB.java:35)
	at org.rocksdb.DBOptions.<clinit>(DBOptions.java:21)
	at 

原因分析

  1. 缺少 JNI 动态库依赖 :RocksDB Java 依赖 rocksdbjni,需要正确的本地动态库(.dylib)文件。

  2. 依赖未引入 :Java 层需要 rocksdbjni 的 Maven 依赖

解决方案

  1. 添加 Java 依赖

    在项目的 pom.xml 中引入 RocksDB Java 依赖:

    xml 复制代码
    <dependency>
        <groupId>org.rocksdb</groupId>
        <artifactId>rocksdbjni</artifactId>
        <version>8.3.2</version> <!-- 请使用最新稳定版本 -->
    </dependency>

添加依赖之后 RocksDB 会以内嵌库的形式打包进应用,无需单独安装系统级 RocksDB。

总结

  • 必须引入 rocksdbjni 依赖,否则缺少 JNI 支持。

这样 macOS M系列 上即可成功运行 RocksDB。

相关推荐
望获linux11 小时前
【Linux基础知识系列:第一百四十篇】理解SELinux与系统安全
linux·运维·服务器·数据库·chrome·macos
Insist75312 小时前
基于OpenEuler部署kafka消息队列
分布式·docker·kafka
奇舞精选14 小时前
CEF框架实践:构建Mac混合桌面应用
macos·浏览器
励志成为糕手15 小时前
Kafka选举机制深度解析:分布式系统中的民主与效率
分布式·kafka·linq·controller·isr机制
飞鱼&18 小时前
Kafka-保证消息消费的顺序性及高可用机制
分布式·kafka
shallwe小威19 小时前
SpringBoot集成Kafka
spring boot·后端·kafka
Lbwnb丶19 小时前
通过kafka-connect 实现debezium数据监听采集
分布式·kafka
syty202019 小时前
kafka vs rocketmq
分布式·kafka·rocketmq
飞鱼&20 小时前
Kafka-消息不丢失
分布式·kafka
lifallen20 小时前
Kafka Rebalance机制全解析
分布式·kafka