GraalVM原生编译使Spring Boot应用编译为无需JVM的本地可执行文件，启动快、内存低、包小，适用于Serverless等场景，但需Spring Boot 3.x、GraalVM JDK及AOT预处理适配。
什么是GraalVM原生编译对Spring Boot的意义
GraalVM原生编译（Native Image）能把Spring Boot应用直接编译成独立的、无需JVM的本地可执行文件。启动快（毫秒级）、内存占用低、部署包小，适合Serverless、边缘计算或容器轻量化场景。但不是所有Spring Boot项目都能一键原生——它要求代码在构建时可静态分析，对反射、动态代理、资源加载等有严格约束。
前置条件和环境准备
必须使用Spring Boot 3.x（官方原生支持从3.0开始），且JDK需为GraalVM JDK（非普通OpenJDK）。推荐用GraalVM CE 22.3+ 或 23.x，配合Maven或Gradle插件构建。
- 安装GraalVM JDK并设为默认JAVA_HOME
- 运行gu install native-image安装native-image工具
- 确保Spring Boot项目已升级到3.1+（3.2+更稳定，修复大量原生兼容问题）
- 添加spring-boot-starter-native依赖（Maven）或启用spring-aot-maven-plugin
关键配置与适配要点
Spring Boot通过Spring AOT（Ahead-of-Time）在构建期预处理：将反射、序列化、代理等元数据提前生成，供GraalVM编译器识别。你不需要手写reflect-config.json，但需注意：
- 避免运行时拼接类名、动态Class.forName()；必须显式声明反射需求（用@RegisterReflectionForBinding或build-time hints）
- JSON序列化框架建议用Jackson（Spring默认），禁用Gson或自定义反序列化逻辑，除非提供AOT hint
- 数据库连接池改用HikariCP（Tomcat JDBC不支持原生），JDBC驱动需用支持原生的版本（如PostgreSQL 42.6+、MySQL 8.0.33+）
- 禁用Spring Boot DevTools、Actuator中的某些端点（如/threaddump、/heapdump），它们依赖JVM内部API
构建与验证原生镜像
执行Maven命令：./mvnw -Pnative native:compile（需先配置native profile）。成功后生成target/{app-name}可执行文件。
立即学习“Java免费学习笔记（深入）”；
- 运行./target/your-app，观察启动日志是否含“Started XXX in X ms”（通常
- 用lsof -i :8080确认进程无JVM相关线程，ps aux看RSS内存常低于30MB
- 若报错“ClassNotFoundException”或“Method resolution failed”，说明某处反射未注册，查build/native/nativeCompile目录下的report目录定位缺失hint
