SpringBoot3.x原生镜像-Native Image尝鲜
Posted Java知音_
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了SpringBoot3.x原生镜像-Native Image尝鲜相关的知识,希望对你有一定的参考价值。
前提
Spring
团队致力于为Spring
应用程序提供原生映像支持已经有一段时间了。在SpringBoo2.x
的Spring Native
实验项目中酝酿了3年多之后,随着Spring Framework 6
和Spring Boot 3
的发布,对应的项目就是Spring Native
,原生镜像支持将会发布GA
版本(换言之就是,Native Image
相关支持会在Spring Boot 3
的GA
版本中一起发布)。
❝前面这一段简介摘抄自参考资料中的《Native Support in Spring Boot 3.0.0-M5》
❞
笔者在写这篇文章(2022-10-28
)前后SpringBoot
尚未发布3.x GA
,版本3.0.0-M5+
算是GA
前相对稳定的版本,这里选用当前3.x
的最新非GA
版本3.0.0-RC1
进行调研。
什么是Native Image
Native Image
,这里直译为原生镜像或者本地镜像,是一种提前将(Java
)代码编译为二进制文件(原生可执行文件,native executable
)的技术。原生可执行文件只包含运行时所需要的代码,即应用程序类、标准库类、语言运行时和来自JDK
的静态链接的原生代码(也就是**这样的二进制文件可以直接运行,不需要额外安装JDK
**)。由原生镜像生成的可执行文件有几个重要的优点:
使用
Java
虚拟机所需资源的一小部分,因此运行成本更低启动时间大幅度下降,以毫秒为单位
不需要进行预热即可提供最佳性能
可以打包到轻量级容器映像中以便快速有效地部署
减少了攻击面(这个和网络安全相关)
Spring Boot 3
中「使用GraalVM
方案提供Native Image
支持」。
安装GraalVM
在https://www.graalvm.org/downloads - Download GraalVM页面中下载对应操作系统的GraalVM
:
笔者开发环境使用的操作系统是Windows10
,下载和选用下图中的安装包:
解压完成后配置一下JAVA_HOME
、GRAALVM_HOME
并且把GRAALVM_HOME\\bin
添加到PATH
中。完成后可以执行一下java -version
进行验证:
❝如果已经安装了其他版本的JDK,先暂时全局替换为GraalVM,也就是JAVA_HOME、GRAALVM_HOME同时配置为GraalVM的解压目录,因为目前看来这样做才能正常打包原生镜像
❞
确定GraalVM
版本无误,到此安装完成。另外,需要配置好了Maven
,建议重新安装一个3.6.x+
版本的Maven
并且把MAVEN_HOME\\bin
添加到PATH
中。
编写应用程序
新建一个命名为spring-boot-native-image
的Maven
项目或者模块,选用刚才下载好的GraalVM
:
项目的POM
文件引入下面几组依赖:
spring
的快照repository
,因为需要下载RC1
版本依赖,暂时不能从中央仓库拉取spring-boot-starter-parent
,定义版本为RC1
native-maven-plugin
插件,用于原生镜像打包spring-boot-starter-web
,用于构建一个简单的web
项目
<!-- spring-boot-starter-parent -->
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.0.0-RC1</version>
</parent>
<!-- repository -->
<repositories>
<repository>
<id>spring-snapshots</id>
<url>https://repo.spring.io/snapshot</url>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>spring-milestones</id>
<url>https://repo.spring.io/milestone</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>spring-snapshots</id>
<url>https://repo.spring.io/snapshot</url>
</pluginRepository>
<pluginRepository>
<id>spring-milestones</id>
<url>https://repo.spring.io/milestone</url>
</pluginRepository>
</pluginRepositories>
<!-- spring-boot-starter-web -->
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
<!-- native-maven-plugin -->
<plugins>
<plugin>
<groupId>org.graalvm.buildtools</groupId>
<artifactId>native-maven-plugin</artifactId>
<version>0.9.16</version>
<extensions>true</extensions>
<executions>
<execution>
<id>build-native</id>
<goals>
<goal>compile-no-fork</goal>
</goals>
<phase>package</phase>
</execution>
<execution>
<id>test-native</id>
<goals>
<goal>test</goal>
</goals>
<phase>test</phase>
</execution>
</executions>
<configuration>
<mainClass>cn.vlts.NativeApplication</mainClass>
<imageName>native-app</imageName>
<buildArgs>
<buildArg>--verbose</buildArg>
</buildArgs>
</configuration>
</plugin>
</plugins>
最终的POM
文件看起来如下:
项目中只有一个启动类cn.vlts.NativeApplication
,编写了main
方法和一个用于集成测试的控制器方法:
@RestController
@SpringBootApplication
public class NativeApplication
public static void main(String[] args)
SpringApplication.run(NativeApplication.class, args);
@GetMapping(path = "/hello")
public ResponseEntity<String> hello()
return ResponseEntity.ok("world");
打包和调试
完成项目配置和代码编写后,执行下面的Maven
命令进行打包:
mvn package -Pnative
打包过程可能会遇到下面的问题:
最有可能的问题:
Default native-compiler executable 'cl.exe' not found via environment variable PATH
解决方案在Stackoverflow
对应的问题回答中找到:
其实就是在Window
操作系统开发环境下基于GraalVM
构建原生镜像依赖Microsoft Visual C++ (MSVC)
,建议安装MSVC 2017 15.5.5+
,可以安装Visual Studio (2019)
并且安装对应的MSVC
。
因为很早之前笔者在调试Rust
时候已经安装过Visual Studio 2019
用于其debug
工具链,这里无须进行安装。在安装Visual Studio
勾选MSVC vXXX
的组件进行安装即可,然后需要把对应的MSVC
工具的bin
目录添加到PATH
中(这个目录一般是VS_HOME\\VC\\Tools\\MSVC\\版本号\\bin\\Hostx64\\x64
):
其次可能遇到的问题:打包过程出现
stdio.h
库文件报错或者找不到主类Main entry point class 'app.jar' not found x.y.Application
其实还是因为MSVC
的问题,在GraalVM
文档中有提示如下:
简单来说就是「必须在Visual Studio
自带的命令行工具x64 Native Tools Command Prompt
中执行native image
相关命令」,这个命令行工具初始化如下:
在x64 Native Tools Command Prompt
中先进入目标项目根目录,然后执行mvn -Pnative package
:
最终看到BUILD SUCCESS
字眼,项目的target
目录下可以看到一个.exe
和一个.jar
文件,而.exe
文件就是前面一直提到的「可执行的二进制文件」:
直接运行它:
可以看到这个文件运行完全不依赖外部Java
虚拟机,并且启动速度极快(600
毫秒左右),可以用POSTMAN
等工具测试程序接口:
到此可以验证程序功能正常。
小结
SpringBoot3.x
原生镜像正式发布后会是SpringBoot
在云原生领域的一个巨大进步,让我们拭目以待。但是就目前来看,常用的Windows
开发环境下想要尝试native image
技术需要解决比较多的问题,Linux
和Unix
平台下尚未验证,希望后面的版本迭代能够降低使用难度并且支持一个命令多平台打包的功能。
参考资料:
Native Support in Spring Boot 3.0.0-M5
GraalVM - Quick Start Guide
(本文完 c-2-d e-a-20221030 封面自剃须)
推荐
PS:因为公众号平台更改了推送规则,如果不想错过内容,记得读完点一下“在看”,加个“星标”,这样每次新文章推送才会第一时间出现在你的订阅列表里。点“在看”支持我们吧!
以上是关于SpringBoot3.x原生镜像-Native Image尝鲜的主要内容,如果未能解决你的问题,请参考以下文章
Spring Boot 学习总结(31)—— Spring Native 主要知识点总结