回顾

大家好，我是老马。

最近 dubbo3.x 在公司内部分享，于是想系统梳理一下。

总体思路是官方文档入门+一些场景的问题思考+源码解析学习。

Dubbo AOT 技术详解，如何使用 GraalVM Native Image 实现 Dubbo 应用静态化

在 Dubbo 3.3.0 版本中，我们正式发布了 Dubbo AOT 静态化解决方案。

本文档将介绍将介绍如何借助 Dubbo AOT 技术将应用接入 GraalVM Native Image，将应用编译为 Native 二进制包的流程以及目前支持的组件。

使用场景

• 本机映像编译：将应用程序预编译为本机映像，缩短启动时间并减少内存使用。
• 语言互操作：GraalVM 能够用多种语言编写代码，在同一应用程序中进行互操作。
• 优化：GraalVM 为用 Java、JavaScript 和其他语言编写的应用程序提供优化，提高 Dubbo 应用程序的性能。
• Polyglot 调试：GraalVM 能够在同一会话中调试用多种语言编写的代码，对复杂 Dubbo 应用程序中的问题进行故障排除时非常有用。
• Java 运行时：可以在 GraalVM 上运行，提供更快、更高效的 Java 运行时环境。
• 开发微服务：可以与 GraalVM 结合，创建高性能、低资源利用率的微服务。

使用方式

在编译我们的dubbo项目之前，需要确保我们正基于graalVm的环境。

第一步：安装GraalVM

1. 在Graalvm官网根据自己的系统选取对应Graalvm版本：https://www.graalvm.org/downloads/
2. 根据官方文档安装native-image：https://www.graalvm.org/latest/reference-manual/native-image/#install-native-image

第二步：配置profiles

其中包括maven-compiler-plugin、spring-boot-maven-plugin、native-maven-plugin、dubbo-maven-plugin，修改dubbo-maven-plugin中的mainClass为所需的启动类全路径。（其中API使用方式无需添加spring-boot-maven-plugin依赖。）

        
            native
            
                
                    
                        maven-compiler-plugin
                        
                            17
                            true
                            true
                        
                    
                    
                        org.springframework.boot
                        spring-boot-maven-plugin
                        
                            
                                process-aot
                                
                                    process-aot
                                
                            
                        
                    
                    
                        org.graalvm.buildtools
                        native-maven-plugin
                        0.9.25
                        
                            ${project.build.outputDirectory}
                            
                                true
                            
                            22.3
                        
                        
                            
                                add-reachability-metadata
                                
                                    add-reachability-metadata
                                
                            
                        
                    
                    
                        org.apache.dubbo
                        dubbo-maven-plugin
                        ${dubbo.version}
                        
                            com.example.nativedemo.NativeDemoApplication
                        
                        
                            
                                process-sources
                                
                                    dubbo-process-aot

第三步：在Pom依赖中添加native相关的依赖：

其中API使用方式无需添加dubbo-config-spring6依赖。

    org.apache.dubbo
    dubbo-config-spring6
    ${dubbo.version}


    org.apache.dubbo
    dubbo-native
    ${dubbo.version}

第四步：配置应用

示例配置如下：

dubbo:
  application:
    name: ${spring.application.name}
    logger: slf4j
  protocol:
    name: dubbo
    port: -1
    serialization: fastjson2
  registry:
    id: zk-registry
    address: zookeeper://127.0.0.1:2181
  config-center:
    address: zookeeper://127.0.0.1:2181
  metadata-report:
    address: zookeeper://127.0.0.1:2181
  provider:
    serialization: fastjson2
  consumer:
    serialization: fastjson2

第五步：编译

在项目根路径下执行以下编译命令：

mvn clean install -P native -Dmaven.test.skip=true

• 注解和xml方式（Springboot3集成的方式）

mvn clean install -P native native:compile -Dmaven.test.skip=true

第六步：执行二进制文件即可

二进制文件在target/目录下，一般以工程名称为二进制包的名称，比如target/native-demo

支持的组件以及对应的版本

日志组件

组件名称	所需的插件	插件版本	备注
Apache Commons Logging	native-maven-plugin	0.9.24 及其以上
JDK Logger	native-maven-plugin	0.9.24 及其以上
slf4j	spring-boot-maven-plugin	3.x.x (用最新版本即可)
Log4j	native-maven-plugin	0.10.0 及其以上
Log4j2

序列化组件

组件名称	所需的插件	插件版本	备注
FastJson2	dubbo-maven-plugin	3.3.0 及其以上
JDK	native-maven-plugin	0.9.24 及其以上
Hessian-Lite			对JDK 17支持不友好，暂不支持

注册中心组件

组件名称	所需的插件	插件版本	备注
Zookeeper	dubbo-maven-plugin	3.3.0	仅支持Zookeeper Curator5

元数据中心组件

组件名称	所需的插件	插件版本	备注
Zookeeper	dubbo-maven-plugin	3.3.0	仅支持Zookeeper Curator5

配置中心组件

组件名称	所需的插件	插件版本	备注
Zookeeper	dubbo-maven-plugin	3.3.0	仅支持Zookeeper Curator5

可观测性组件

组件名称	所需的插件	插件版本	备注
Micrometer

参考资料

https://cn.dubbo.apache.org/zh-cn/overview/mannual/java-sdk/reference-manual/graalvm/support-graalvm/