GraalVM Native Image — 스프링 애플리케이션을 네이티브로 컴파일하는 방법

// build.gradle
plugins {
    id 'org.graalvm.buildtools.native' version '0.10.4'
    id 'org.springframework.boot' version '3.4.0'
}

// Maven — pom.xml
// <parent>
//   <artifactId>spring-boot-starter-parent</artifactId>
//   <version>3.4.0</version>
// </parent>
// native 프로필이 자동 포함됨

# Gradle
./gradlew nativeCompile

# Maven
./mvnw -Pnative native:compile

# Docker 이미지로 빌드 (GraalVM 설치 불필요)
./gradlew bootBuildImage
# 또는
./mvnw -Pnative spring-boot:build-image

# 빌드된 바이너리 직접 실행
./build/native/nativeCompile/my-app

# 시작 시간 비교
# JVM: Started MyApp in 3.245 seconds
# Native: Started MyApp in 0.065 seconds  ← 약 50배 빠름

// 런타임에 동적으로 클래스에 접근 — 네이티브 이미지에서 실패할 수 있음
Class<?> clazz = Class.forName("com.example.MyClass");
Object obj = clazz.getDeclaredConstructor().newInstance();

// JDK 동적 프록시 — 빌드 시점에 프록시 대상을 알아야 함
Proxy.newProxyInstance(
    classLoader,
    new Class<?>[]{ MyInterface.class },
    invocationHandler
);

// 리소스 파일도 명시적으로 포함시켜야 함
getClass().getResourceAsStream("/config/rules.json");

// Serializable 클래스도 hints 등록 필요
class MyDto implements Serializable { ... }

@Component
@ImportRuntimeHints(MyRuntimeHints.class)
public class MyService {
    // 리플렉션으로 접근하는 로직
}

public class MyRuntimeHints implements RuntimeHintsRegistrar {

    @Override
    public void registerHints(RuntimeHints hints, ClassLoader classLoader) {
        // 리플렉션 힌트
        hints.reflection()
            .registerType(MyDto.class,
                MemberCategory.INVOKE_DECLARED_CONSTRUCTORS,
                MemberCategory.INVOKE_DECLARED_METHODS,
                MemberCategory.DECLARED_FIELDS);

        // 리소스 힌트
        hints.resources()
            .registerPattern("config/*.json")
            .registerPattern("templates/*.html");

        // JDK 프록시 힌트
        hints.proxies()
            .registerJdkProxy(MyInterface.class);

        // 직렬화 힌트
        hints.serialization()
            .registerType(MyDto.class);
    }
}

@RestController
@RegisterReflectionForBinding({
    UserResponse.class,
    OrderResponse.class,
    ErrorResponse.class
})
public class ApiController {
    // Jackson이 이 DTO들에 리플렉션 접근
}

// src/main/resources/META-INF/native-image/reflect-config.json
[
  {
    "name": "com.example.dto.UserResponse",
    "allDeclaredConstructors": true,
    "allDeclaredMethods": true,
    "allDeclaredFields": true
  }
]

[소스 코드]
    ↓ AOT 처리 (빌드 시점)
[빈 정의 코드 생성]     — XML/어노테이션 → 직접 Java 코드로 변환
[프록시 클래스 생성]     — CGLIB 프록시를 빌드 시점에 생성
[리플렉션 hints 자동 생성] — Spring이 사용하는 리플렉션 정보 수집
    ↓ native-image 컴파일
[네이티브 바이너리]

# Gradle
./gradlew nativeTest

# Maven
./mvnw -Pnative test

// AOT 처리된 테스트
@SpringBootTest
class MyServiceTest {

    @Test
    void contextLoads() {
        // 네이티브 이미지로 빌드 후 실행되는 테스트
    }
}

# GitHub Actions 예시
jobs:
  native-build:
    runs-on: ubuntu-latest
    steps:
      - uses: graalvm/setup-graalvm@v1
        with:
          java-version: '21'
          distribution: 'graalvm'
      - run: ./gradlew nativeCompile
      - run: ./build/native/nativeCompile/my-app &
      - run: curl --retry 10 --retry-delay 1 http://localhost:8080/actuator/health