编译spring boot 3 native + jpa的原生镜像

其中涉及版本:
maven: 3.5.4
jdk: 17
graalvm: 22.3
springboot + jpa: 3.0.8

一、Windows

1、graalvm安装

GraalVM22.3.0安装地址

SpringBoot gzip 会进行数据格式变化吗_spring boot

解压到任意目录后添加JAVA_HOME环境变量

SpringBoot gzip 会进行数据格式变化吗_java_02

新增path:%JAVA_HOME%与%JAVA_HOME%\bin

安装成功:

SpringBoot gzip 会进行数据格式变化吗_可执行文件_03

2、安装VisualStudio

安装VisualStudio

必须的选择:

  1. MSVC v143 - VS 2022 c++ x64/x86生成工具 根据你的jdk版本来选,jdk11需要MSVC v140 2015、jdk15需要MSVC v141 2017、jdk17需要MSVC v142 2019、jdk21需要MSVC v143 2022。当然他们向下兼容,如果你运行中出现了问题,尝试更换对应的版本。
  2. Windows 10 SDK 根据你的windows版本选择,如果说windows10就选择win10

SpringBoot gzip 会进行数据格式变化吗_java_04

SpringBoot gzip 会进行数据格式变化吗_java_05

将cl.exe的目录添加到path中。该程序在笔者的C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.36.32532\bin\Hostx64\x86下,请根据自己安装目录去寻找。

SpringBoot gzip 会进行数据格式变化吗_spring_06

3、安装native-image

使用x64 Native Tools Command Prompt for VS 2022 窗口来安装aot编译器native-image。

SpringBoot gzip 会进行数据格式变化吗_后端_07

gu install native-image:该处我已经提前安装。

SpringBoot gzip 会进行数据格式变化吗_java_08

4、下载spring boot3 native demo

下载demo源码仓库地址spring-native-demo

其中demo中添加了spring-native插件。

<plugin>
 <groupId>org.graalvm.buildtools</groupId>
 <artifactId>native-maven-plugin</artifactId>
</plugin>

springboot3.0配置文件中已经添加了插件依赖,插件的作用就是编译java并且使用操作系统的可执行内核程序进行编译。

SpringBoot gzip 会进行数据格式变化吗_java_09

5、编译可执行文件

据说在linux和mac中是可以直接使用该插件进行编译,但在windows中,需要使用 x64 Native Tools Command Prompt for VS 2022 窗口进行编译。

我们这里采用比较方便的方式进行 x64 Native Tools Command Prompt for VS 2022 窗口编译,该窗口实际上是使用cmd窗口执行以下目标指令,所以我们只需要在idea中设置shell pathcmd+执行指令就可以直接使用idea的Terminal窗口进行编译了。

SpringBoot gzip 会进行数据格式变化吗_spring_10

SpringBoot gzip 会进行数据格式变化吗_后端_11

SpringBoot gzip 会进行数据格式变化吗_后端_12

配置好后,Terminal中打印native窗口内容,就代表配置成功了。

SpringBoot gzip 会进行数据格式变化吗_spring boot_13

此时只需要我们执行编译指令mvn install -Pnative native:compile -DskipTests=true,等待后即可编译成功。会在target目录下生成exe可执行文件。

SpringBoot gzip 会进行数据格式变化吗_spring_14

6、执行可执行文件效果

执行exe文件。

SpringBoot gzip 会进行数据格式变化吗_spring boot_15

在配置了spring data jpamysql数据源的情况下,启动时间很乐观。

SpringBoot gzip 会进行数据格式变化吗_spring boot_16

二、Linux

1、graalvm安装

下载graalvm linux与native-image的安装jar。

SpringBoot gzip 会进行数据格式变化吗_spring boot_17

SpringBoot gzip 会进行数据格式变化吗_java_18

graalvm jdk解压后到任意目录后,将该目录添加到环境变量

vim /etc/profile

source /etc/profile

SpringBoot gzip 会进行数据格式变化吗_spring_19

SpringBoot gzip 会进行数据格式变化吗_java_20

2、安装gcc

yum install -y gcc

3、安装native-image

使用刚下载的安装包安装native-image

gu -L install native-image-installable-svm-java17-linux-amd64-22.3.0.jar

SpringBoot gzip 会进行数据格式变化吗_java_21

4、克隆springboot3 native demo,编译可执行文件
git clone https://github.com/wdragondragon/spring-native-demo.git
cd spring-native-demo/
mvn install -Pnative native:compile -X -DskipTests=true</pre>

过程中可能会出现status 137的异常,该异常的出现是编译时内存不足导致oom,请在编辑mvn启动脚本,提高堆内存大小。

SpringBoot gzip 会进行数据格式变化吗_spring boot_22

发现会使用环境变量MAVEN_OPTS来追加mvn启动的jvm参数。

SpringBoot gzip 会进行数据格式变化吗_后端_23

随后在/etc/profile添加以下内容,source /etc/profile后,再次执行编译。即可编译成功。

SpringBoot gzip 会进行数据格式变化吗_后端_24

5、执行可执行文件效果

编译成功后,target/spring-native-demo为可执行文件,启动可执行文件。配置了jpa的启动速度也十分乐观。

SpringBoot gzip 会进行数据格式变化吗_spring boot_25

三、可能会出现的异常

在笔者编写该文章时,最新的springboot的ga版本已经是3.1.1了。有可能会有读者会将springboot的版本提升到最新。

SpringBoot gzip 会进行数据格式变化吗_spring_26

但在基于最新GA版本的springboot编译成可执行文件后,启动时会出现以下问题。会导致JpaRepository的interface method派生查询出现动态代理的异常。

SpringBoot gzip 会进行数据格式变化吗_后端_27

可以查看demo中的commit history,其中我尝试过使用-H:DynamicProxyConfigurationFiles指定dynamic-proxy.json来解决,也尝试过引入旧版springboot2.x中的spring-native来申明Hint。但都无济于事。最后在graalvm-reachability-metadata这个子项目中的issue中找到一些蛛丝马迹。

其中感谢derkoe的提醒,我将springboot的版本降低到了上一个GA版本3.0.8,然后再编译十分顺利了。

SpringBoot gzip 会进行数据格式变化吗_可执行文件_28