SpringBoot加载JNA失败解决方法
时间:2025-09-16 18:56:21 287浏览 收藏
在使用 Spring Boot 构建 Docker 镜像时,你是否在 M1 Mac 上遇到了 "Can't load library" 的 JNA 加载失败错误?本文针对此问题,提供了一套有效的解决方案。该问题通常由于 JNA 库与 Spring Boot、Spring Cloud 及 Java 版本不兼容所致。本文将详细指导你如何调整 Maven 项目中的版本依赖,包括升级 Spring Boot 到 2.7.5 或更高版本,Java 到 17 或更高版本,以及选择与 Spring Boot 兼容的 Spring Cloud 版本(如 2021.0.5)。通过修改 `pom.xml` 文件并确保版本兼容性,可以顺利解决 M1 Mac 上 Spring Boot 镜像构建失败的问题,并附带完整的 `pom.xml` 示例供参考。

本文旨在帮助开发者解决在使用 Spring Boot 构建 Docker 镜像时,在 M1 Mac 上遇到的 "Can't load library" 错误,该错误通常与 JNA (Java Native Access) 库加载失败有关。通过调整 Spring Boot、Spring Cloud 和 Java 的版本兼容性,可以有效地解决此问题,确保镜像构建顺利进行.
在 M1 Mac 上使用 Spring Boot 构建 Docker 镜像时,可能会遇到如下错误:Can't load library: /Library/Caches/JNA/temp/jna10957970510011304471.tmp。 这个问题通常与 JNA 库的版本兼容性有关,尤其是在使用较新版本的 macOS 和 Apple Silicon 芯片时。 以下提供了一种有效的解决方案,即通过调整 Maven 项目中的 Spring Boot、Spring Cloud 和 Java 版本,以确保它们之间的兼容性。
解决方案:调整版本依赖
问题的核心在于 Spring Boot、Spring Cloud 和 Java 版本的兼容性。 不兼容的版本可能导致 JNA 库加载失败,从而阻止镜像的成功构建。 以下步骤详细说明了如何修改 pom.xml 文件来解决这个问题。
修改 Spring Boot 版本:
将
标签中的 spring-boot-starter-parent 版本更新到 2.7.5 或更高版本。 例如: org.springframework.boot spring-boot-starter-parent 2.7.5 修改 Java 版本:
将
标签中的 java.version 更新到 17 或更高版本。 例如: 17 2021.0.5 修改 Spring Cloud 版本:
将
标签中的 spring-cloud.version 更新到与 Spring Boot 版本兼容的版本。 对于 Spring Boot 2.7.5,Spring Cloud 2021.0.5 是一个合适的选择。 例如: 17 2021.0.5 更新 dependencyManagement 中的 Spring Cloud 版本:
确保
标签中 spring-cloud-dependencies 的版本与 中定义的 spring-cloud.version 相匹配。 org.springframework.cloud spring-cloud-dependencies ${spring-cloud.version} pom import 完整 pom.xml 示例:
以下是一个修改后的 pom.xml 文件的示例,其中包含了上述所有更改:
4.0.0 org.springframework.boot spring-boot-starter-parent 2.7.5 com.in28minutes.microservices currency-exchange-service 0.0.1-SNAPSHOT currency-exchange-service-docker Demo project for Spring Boot 17 2021.0.5 org.springframework.boot spring-boot-starter-actuator org.springframework.boot spring-boot-starter-web org.springframework.boot spring-boot-starter-data-jpa com.h2database h2 org.springframework.cloud spring-cloud-starter-config org.springframework.cloud spring-cloud-starter-sleuth org.springframework.cloud spring-cloud-sleuth-zipkin org.springframework.cloud spring-cloud-starter-netflix-eureka-client org.springframework.boot spring-boot-starter-aop io.github.resilience4j resilience4j-spring-boot2 org.springframework.boot spring-boot-devtools runtime true org.springframework.boot spring-boot-starter-test test org.springframework.cloud spring-cloud-dependencies ${spring-cloud.version} pom import org.springframework.boot spring-boot-maven-plugin ingllot/mmv2-${project.artifactId}:${project.version} IF_NOT_PRESENT spring-milestones Spring Milestones https://repo.spring.io/milestone
注意事项
- 版本兼容性: 务必确保 Spring Boot、Spring Cloud 和 Java 版本之间的兼容性。 可以参考 Spring Cloud 官方文档,查找与特定 Spring Boot 版本兼容的 Spring Cloud 版本。
- 清理缓存: 在修改 pom.xml 文件后,建议清理 Maven 缓存并重新构建项目。 可以使用 mvn clean install 命令来完成此操作。
- JDK 版本: 确保你的 IDE (如 IntelliJ IDEA) 和 Maven 使用的是相同的 JDK 版本。 可以在 IDE 的设置中配置 JDK。
总结
通过调整 Spring Boot、Spring Cloud 和 Java 的版本,可以有效地解决在 M1 Mac 上构建 Spring Boot Docker 镜像时遇到的 JNA 加载失败问题。 关键在于确保这些依赖项之间的兼容性,并遵循上述步骤修改 pom.xml 文件。 在修改后,清理缓存并重新构建项目,应该能够成功构建 Docker 镜像。 如果在尝试这些步骤后仍然遇到问题,请检查 Maven 和 JDK 的配置,并确保它们与项目所需的版本匹配。
文中关于的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《SpringBoot加载JNA失败解决方法》文章吧,也可关注golang学习网公众号了解相关技术文章。
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
182 收藏
-
文章 · java教程 | 4天前 | 性能优化 · Java教程 · CompletableFuture · 接口聚合 · java completablefuture orTimeout completeOnTimeout 接口性能 P95255 收藏
-
文章 · java教程 | 4天前 | Spring Boot · Java教程 · 接口设计 · Webhook · 幂等设计 · java spring boot WebHook 回调接口 幂等 状态流转 验签488 收藏
-
文章 · java教程 | 6天前 | Java教程 · TTL缓存 · ConcurrentHashMap · 小项目 · java 本地缓存 concurrenthashmap TTL缓存 过期淘汰394 收藏
-
355 收藏
-
495 收藏
-
365 收藏
-
455 收藏
-
文章 · java教程 | 2星期前 | hashmap · 集合 · Java教程 · hashCode · equals · java HashMap map equals hashCode 可变key474 收藏
-
178 收藏
-
文章 · java教程 | 2星期前 | map · 并发安全 · 缓存设计 · Java教程 · java optional concurrenthashmap computeIfAbsent Map缓存236 收藏
-
204 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习