Java JAR包中定义的对象在Scala文件中无法访问

1. 确认JAR包有效性 #

• 解压JAR包或用命令jar tf your-library.jar查看内部文件结构，确认目标类存在，且包路径与你预期一致。避免因JAR本身损坏、类缺失或包名不符导致无法访问。

2. 修正构建工具依赖配置（以sbt为例） #

本地JAR的正确引入方式 #

• 若为单模块项目，将JAR放在项目根目录的lib文件夹下即可；多模块项目需放到对应子模块的lib目录（如subproject/lib），而非project/subproject/lib。
• 或在build.sbt中显式声明本地依赖，注意路径格式：

// Linux/macOS
libraryDependencies += "自定义组名" % "库名" % "版本号" from "file:///绝对路径/your-library.jar"

// Windows
libraryDependencies += "自定义组名" % "库名" % "版本号" from "file:///C:/绝对路径/your-library.jar"

清理并刷新依赖 #

执行sbt clean、sbt reload、sbt update，强制构建工具重新加载依赖，规避缓存导致的依赖未生效问题。

3. 检查JVM版本兼容性 #

确认JAR包的编译JVM版本与项目运行的JVM版本匹配。比如JAR用Java 17编译，项目却用Java 8运行，会导致类无法加载。可在build.sbt中指定JVM版本：

javaHome := Some(file("/path/to/jdk-对应版本"))
javacOptions ++= Seq("-source", "对应版本号", "-target", "对应版本号")

4. 验证依赖是否被正确加载 #

• 在sbt控制台执行show libraryDependencies，确认本地JAR已在依赖列表中。
• 执行show dependencyClasspath，检查JAR路径是否被包含在类路径内。

5. 检查代码引用正确性 #

• 确保导入的包名与JAR内类的实际包名完全一致，比如JAR内类为com.example.tools.Utils，不能错误写成import com.example.Utils。
• 尝试用全限定名直接引用类（如val util = new com.example.tools.Utils()），排除导入语句的问题。

6. 安装到本地Maven仓库（备选方案） #

若上述方法无效，可将JAR安装到本地Maven仓库后再引入：

mvn install:install-file -Dfile=/path/to/your-library.jar -DgroupId=自定义组名 -DartifactId=库名 -Dversion=版本号 -Dpackaging=jar

之后在build.sbt中添加常规依赖：

libraryDependencies += "自定义组名" % "库名" % "版本号"

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