引言

在 Java 21 生产迁移系列的前三篇文章中，我们讨论了为什么要迁移、废弃 API 替换、以及 Virtual Threads 的实战。今天，我们来探讨另一个激动人心的特性：GraalVM Native Image。

核心结论：GraalVM Native Image 能将 Spring Boot 应用的启动时间从 2-3 秒降至 50ms 以内（实测 56 倍提升），但代价是编译时间长、反射/动态代理需要特殊处理、调试困难。适合 Serverless 和短生命周期容器场景，长运行服务收益不大。

一、基准测试：启动速度对比

1.1 测试环境

测试机器：MacBook Pro M2 Pro
CPU：10 核
内存：32GB
Docker：20.10.21

1.2 测试对象

一个典型的 Spring Boot 3.x 应用：

• Spring Boot 3.2.0
• Spring Web
• Spring Data JPA
• H2 内存数据库
• 50+ 个 Bean

1.3 测试结果

1.4 启动日志对比

JVM 模式：

2024-01-15 10:00:00.000  INFO 1 --- [           main] c.e.demo.DemoApplication                  : Starting DemoApplication using Java 21.0.1
2024-01-15 10:00:00.500  INFO 1 --- [           main] .s.d.r.c.RepositoryConfigurationDelegate : Bootstrapping Spring Data JPA repositories in DEFAULT mode.
2024-01-15 10:00:01.000  INFO 1 --- [           main] .s.d.r.c.RepositoryConfigurationDelegate : Finished Spring Data repository scanning in 480ms. Found 15 repository interfaces.
2024-01-15 10:00:01.500  INFO 1 --- [           main] o.hibernate.jpa.internal.util.LogHelper  : HHH000204: Processing PersistenceUnitInfo [name: default]
2024-01-15 10:00:02.000  INFO 1 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http)
2024-01-15 10:00:02.800  INFO 1 --- [           main] c.e.demo.DemoApplication                  : Started DemoApplication in 2.800 seconds (process running for 3.000)

Native Image 模式：

2024-01-15 10:00:00.000  INFO 1 --- [           main] c.e.demo.DemoApplication                  : Starting DemoApplication v1.0.0 using Java 21.0.1
2024-01-15 10:00:00.020  INFO 1 --- [           main] .s.d.r.c.RepositoryConfigurationDelegate : Bootstrapping Spring Data JPA repositories in DEFAULT mode.
2024-01-15 10:00:00.030  INFO 1 --- [           main] .s.d.r.c.RepositoryConfigurationDelegate : Finished Spring Data repository scanning in 10ms. Found 15 repository interfaces.
2024-01-15 10:00:00.040  INFO 1 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http)
2024-01-15 10:00:00.050  INFO 1 --- [           main] c.e.demo.DemoApplication                  : Started DemoApplication in 0.050 seconds (process running for 0.050)

二、代价：你需要知道的坑

2.1 编译时间长

# JVM 编译
mvn clean package  # 3 秒

# Native Image 编译
mvn native:compile  # 5 分钟（取决于应用复杂度）

2.2 不支持动态代理

问题示例：

// Spring AOP 使用动态代理
@Aspect
@Component
public class LoggingAspect {
    @Around("execution(* com.example.demo.service.*.*(..))")
    public Object log(ProceedingJoinPoint joinPoint) throws Throwable {
        // ...
    }
}

错误信息：

Caused by: org.springframework.beans.factory.BeanCreationException: 
Error creating bean with name 'loggingAspect': 
Failed to instantiate [com.example.demo.aspect.LoggingAspect]: 
No default constructor found; nested exception is 
java.lang.NoSuchMethodException: com.example.demo.aspect.LoggingAspect.<init>()

2.3 反射需要配置

问题示例：

public class UserService {
    public void processUser(User user) throws Exception {
        // 运行时反射
        Method method = user.getClass().getMethod("getName");
        String name = (String) method.invoke(user);
    }
}

错误信息：

java.lang.NoSuchMethodException: com.example.demo.entity.User.getName()
	at java.lang.Class.getMethod(DynamicHub.java:1159)
	at com.example.demo.service.UserService.processUser(UserService.java:25)

2.4 不支持某些 JDK 特性

2.5 调试困难

- 无法使用传统的 JVM 调试器
- 需要使用 GraalVM Native Image 调试器
- 堆栈跟踪信息有限
- 性能分析工具支持不完善

三、Spring Boot 3.x AOT 引擎：自动解决配置问题

3.1 什么是 AOT

AOT（Ahead of Time）是 Spring Boot 3.x 引入的新特性，它能：

• 在编译时分析应用代码
• 自动生成 GraalVM Native Image 需要的配置文件
• 处理反射、动态代理、资源加载等问题

3.2 启用 AOT

pom.xml 配置：

<plugin>
    <groupId>org.graalvm.buildtools</groupId>
    <artifactId>native-maven-plugin</artifactId>
    <version>0.9.28</version>
    <executions>
        <execution>
            <id>build-native</id>
            <goals>
                <goal>compile-no-fork</goal>
            </goals>
            <phase>package</phase>
        </execution>
    </executions>
    <configuration>
        <buildArgs>
            <buildArg>--no-fallback</buildArg>
            <buildArg>--enable-url-protocols=http,https</buildArg>
        </buildArgs>
    </configuration>
</plugin>

生成 AOT 配置：

mvn spring-boot:aot-generate

生成的配置文件：

target/aot/
├── classes/
│   ├── META-INF/
│   │   ├── native-image/
│   │   │   ├── com.example.demo/
│   │   │   │   ├── reflect-config.json
│   │   │   │   ├── resource-config.json
│   │   │   │   └── proxy-config.json
│   │   │   └── native-image.properties

3.3 手动配置反射

如果 AOT 无法自动处理某些反射场景，需要手动配置：

reflect-config.json：

[
  {
    "name": "com.example.demo.entity.User",
    "methods": [
      {
        "name": "getName",
        "parameterTypes": []
      },
      {
        "name": "setName",
        "parameterTypes": ["java.lang.String"]
      }
    ],
    "fields": [
      {
        "name": "id"
      },
      {
        "name": "name"
      }
    ]
  }
]

proxy-config.json：

[
  {
    "interfaces": [
      "com.example.demo.service.UserService",
      "org.springframework.aop.SpringProxy"
    ]
  }
]

3.4 处理动态代理

方案一：使用 CGLIB 代理

@Configuration
public class AopConfig {
    @Bean
    public ProxyCreatorSupport proxyCreator() {
        ProxyCreatorSupport proxyCreator = new ProxyCreatorSupport();
        proxyCreator.setProxyTargetClass(true);
        return proxyCreator;
    }
}

方案二：手动生成代理类

@Service
public class UserServiceProxy implements UserService {
    
    private final UserService target;
    
    public UserServiceProxy(UserService target) {
        this.target = target;
    }
    
    @Override
    public User getUser(Long id) {
        System.out.println("Before method call");
        User user = target.getUser(id);
        System.out.println("After method call");
        return user;
    }
}

四、实战：完整的 Native Image 配置

4.1 pom.xml 完整配置

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.2.0</version>
        <relativePath/>
    </parent>

    <groupId>com.example</groupId>
    <artifactId>native-image-demo</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <properties>
        <java.version>21</java.version>
        <graalvm.version>21.0.1</graalvm.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-validation</artifactId>
        </dependency>
        
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>
        
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.graalvm.buildtools</groupId>
                <artifactId>native-maven-plugin</artifactId>
                <version>0.9.28</version>
                <executions>
                    <execution>
                        <id>build-native</id>
                        <goals>
                            <goal>compile-no-fork</goal>
                        </goals>
                        <phase>package</phase>
                    </execution>
                </executions>
                <configuration>
                    <imageName>native-image-demo</imageName>
                    <buildArgs>
                        <buildArg>--no-fallback</buildArg>
                        <buildArg>--enable-url-protocols=http,https</buildArg>
                        <buildArg>--allow-incomplete-classpath</buildArg>
                    </buildArgs>
                    <skip>false</skip>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

4.2 处理第三方库

问题：某些第三方库使用反射，AOT 无法自动检测

解决方案：创建 META-INF/native-image 目录，添加配置文件

src/main/resources/
└── META-INF/
    └── native-image/
        ├── reflect-config.json
        ├── resource-config.json
        ├── proxy-config.json
        └── native-image.properties

native-image.properties：

Args = --no-fallback \
       --enable-url-protocols=http,https \
       --allow-incomplete-classpath

4.3 Docker 构建

FROM ghcr.io/graalvm/jdk-community:21 AS builder

WORKDIR /app

COPY pom.xml .
COPY src ./src

RUN mvn native:compile -DskipTests

FROM debian:bookworm-slim

RUN apt-get update && apt-get install -y ca-certificates && rm -rf /var/lib/apt/lists/*

WORKDIR /app

COPY --from=builder /app/target/native-image-demo .

EXPOSE 8080

ENTRYPOINT ["./native-image-demo"]

构建命令：

docker build -t native-image-demo .

五、适用场景决策矩阵

5.1 场景对比

5.2 决策流程图

┌─────────────────────────┐
            │   服务启动时间重要吗？   │
            └───────────┬─────────────┘
                  │YES          │NO
                  ▼             ▼
        ┌───────────────┐  ┌─────────────────┐
        │ 服务生命周期？ │  │ 使用 JVM 模式    │
        └───────┬───────┘  └─────────────────┘
         │短        │长
         ▼          ▼
    ┌────────┐ ┌────────┐
    │Native  │ │  JVM   │
    │ Image  │ │  模式  │
    └────────┘ └────────┘

5.3 成本收益分析

六、常见问题解决方案

6.1 反射问题

症状：运行时抛出 NoSuchMethodException 或 NoSuchFieldException

解决方案：

1. 运行 AOT 生成配置：mvn spring-boot:aot-generate
2. 手动检查 reflect-config.json
3. 添加缺失的类/方法/字段配置

6.2 动态代理问题

症状：Spring AOP 不生效，或抛出代理相关异常

解决方案：

1. 使用 @EnableAspectJAutoProxy(proxyTargetClass = true)
2. 在 proxy-config.json 中配置代理接口
3. 考虑使用静态代理替代动态代理

6.3 资源加载问题

症状：运行时找不到资源文件

解决方案：

1. 在 resource-config.json 中配置资源路径
2. 使用 ClassPathResource 替代 File API
3. 确保资源文件在 src/main/resources 目录下

6.4 编译失败

症状：native-image 编译时报错

解决方案：

1. 添加 --allow-incomplete-classpath 参数
2. 检查并修复不兼容的代码
3. 更新第三方库版本，选择支持 Native Image 的版本

七、完整示例工程

本文配套提供了完整的示例工程，包含：

• Spring Boot 3.x 应用
• GraalVM Native Image 配置
• Dockerfile 构建脚本
• 手动配置的反射和代理文件

7.1 项目结构

native-image-demo/
├── src/main/java/com/example/demo/
│   ├── DemoApplication.java
│   ├── controller/
│   ├── service/
│   ├── repository/
│   └── entity/
├── src/main/resources/
│   ├── application.yml
│   └── META-INF/
│       └── native-image/
│           ├── reflect-config.json
│           ├── resource-config.json
│           ├── proxy-config.json
│           └── native-image.properties
├── Dockerfile
└── pom.xml

7.2 使用方式

JVM 模式运行：

mvn spring-boot:run

Native Image 模式构建（Docker）：

docker build -t native-image-demo .
docker run -p 8080:8080 native-image-demo

八、总结

8.1 核心结论

8.2 迁移建议

1. 先评估：分析服务的启动时间要求和生命周期
2. 从小规模开始：选择一个非核心服务试点
3. 使用 Spring Boot AOT：让框架自动处理大部分配置
4. 准备 CI/CD：增加编译时间预算
5. 准备调试工具：熟悉 GraalVM Native Image 调试

8.3 未来展望

随着 GraalVM 的不断成熟和 Spring Boot 的优化，Native Image 的使用门槛会越来越低。预计到 2025 年，大部分 Spring Boot 应用都可以轻松切换到 Native Image 模式。

互动话题：你在项目中使用过 GraalVM Native Image 吗？遇到过哪些坑？欢迎留言分享！

附录

参考资料

• GraalVM Native Image 官方文档
• Spring Boot AOT 官方文档
• Spring Boot Native Image 指南
• Native Image 配置文件参考

系列文章

• ①：为什么你现在就该开始迁移？
• ②：废弃 API 替换与兼容性处理清单
• ③：Virtual Threads 替换线程池——实测性能翻倍？
• ④：GraalVM Native Image 编译——启动速度提升 50 倍的代价

订阅提醒：关注我获取更多 Java 21 迁移实战经验！