Java嵌入式数据库Xodus打包为JAR/原生镜像后无法正常工作

1. 数据库路径解析差异 #

Maven exec:java或IntelliJ运行时，工作目录是项目根目录；但用java -jar执行打包后的JAR时，工作目录是你执行命令的当前路径。如果代码中用了相对路径初始化Xodus Environment，会导致两种环境下读写的数据库文件不是同一个，或者打包后的程序找不到正确的数据库文件，进而出现数据混乱。

• 排查：在代码中打印environment.getLocation()的实际路径，对比两种运行方式下的路径是否一致；建议改用绝对路径或者基于程序运行目录的动态路径（比如通过System.getProperty("user.dir")拼接）。

2. 类路径与资源打包问题 #

Xodus依赖内部配置文件（如xodus.properties），如果打包JAR时没有正确包含这些资源，或者代码中用File类加载资源（JAR内资源无法用File访问），会导致Xodus初始化异常，表现为读写功能失效。

• 排查：检查Maven打包插件（assembly/shade）的配置，确保Xodus的所有依赖和资源都被正确打包；资源加载改用ClassLoader.getResourceAsStream()替代File方式。

3. M2 Mac架构兼容性（原生镜像场景） #

如果是用GraalVM打包原生镜像，M2属于ARM64架构，Xodus的部分组件可能依赖特定架构的原生库，若打包时没有适配ARM64，会导致数据处理逻辑异常，出现CSV导出混乱。

• 排查：确认GraalVM版本支持ARM64架构；检查Xodus依赖的原生库是否提供ARM64版本；原生镜像打包时需显式配置Xodus所需的反射、资源访问权限。

4. JVM运行参数差异 #

Maven和IntelliJ默认会设置一些JVM参数（如内存、GC策略），而java -jar默认使用系统默认参数。Xodus对内存配置、文件系统缓存等参数敏感，参数不一致可能导致数据读写时出现异常。

• 排查：导出IntelliJ或Maven运行时的JVM参数（IntelliJ可在Run Configuration中查看VM options；Maven可通过mvn exec:java -Dexec.args="-X"查看），将相同参数添加到java -jar命令中测试，例如：java -Xmx512m -XX:+UseG1GC -jar your-app.jar。

5. 事务与资源未正确释放 #

打包运行后，可能存在程序退出时未关闭Xodus Environment，或者事务未提交的情况，导致数据库文件损坏，读取时出现数据混乱。

• 排查：确认代码中在程序退出前调用了environment.close()；检查所有读写操作的事务都执行了txn.commit()，避免未提交事务导致的数据不一致。

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