JDK 25 一页速查卡

• 正式：506 Scoped Values、511 模块导入、512 紧凑源文件/实例 main、513 灵活构造器体、514/515 AOT、510 KDF、503 移除 32 位 x86
• 预览：505 结构化并发（第五次）、502 Stable Values、507 原始类型模式、470 PEM、508 Vector API
• 产品但默认关闭：519 紧凑对象头、521 分代 Shenandoah
• 仍是 LTS：25 于 2025-09-16 发布，class 文件版本 69

「转正」是支持级别，不是默认值；「预览」是 API 仍可能改，不是 beta 正式版。

javac --release 25 --enable-preview App.java
java --enable-preview App
javap -verbose App | grep major

25 的 class 是 69；预览 class 是 69.65535，只能由 25 运行。正式特性不要加 --enable-preview；21 的预览 class 是 65.65535，25 不认。

• 是否仍依赖 32 位 x86；该端口已在 25 移除
• 是否还在用 Security Manager 或 Thread.stop（25 抛 UOE）
• 预览 class 是否随 JDK 升级重新编译
• 结构化并发是否仍按 21 的 ShutdownOnFailure 写
• ScopedValue 是否还在用 runWhere / callWhere / getWhere
• 紧凑对象头 / 分代 Shenandoah 是否被误认为默认开启

升级顺序：先编译通过，再跑测试，再做运行时开关 A/B，最后切默认与灰度。

static final ScopedValue<User> USER = ScopedValue.newInstance();

ScopedValue.where(USER, user)
        .where(TRACE_ID, req.traceId())
        .run(() -> service.handle(req));

嵌套遮蔽、异常/结束自动恢复。结构化 fork 继承；手工线程与线程池不继承。没有 set/remove。

try (var scope = StructuredTaskScope.open(
        StructuredTaskScope.Joiner.<String>allSuccessfulOrThrow())) {
    var a = scope.fork(() -> "a");
    var b = scope.fork(() -> "b");
    scope.join().forEach(s -> IO.println(s.get()));
}

21 的 ShutdownOnFailure / ShutdownOnSuccess 已移除。编译和运行都要 --enable-preview，且必须是同一个 JDK 25。

try (var scope = StructuredTaskScope.open(
        StructuredTaskScope.Joiner.<String>anySuccessfulResultOrThrow(),
        cfg -> cfg.withTimeout(java.time.Duration.ofMillis(100)))) {
    scope.fork(() -> callRemote());
    return scope.join();
} catch (StructuredTaskScope.TimeoutException e) {
    throw new RuntimeException("timeout", e);
}

超时是 TimeoutException，不是 FailedException。close 会取消并等待；中断是协作式的，吞中断会让 close 阻塞。

void main() {
    IO.println("hello, jdk 25");
}

java Hello.java 在内存中编译运行；不能有 package；IO 静态方法不再隐式导入，要写 IO.println。隐式类 final、包私有。

import module java.base;

void main() {
    IO.println(List.of("a", "b"));
}

导入模块导出的包 + transitive requires 的导出包；不替代 requires，不改变运行时模块图，不能导入 classpath 未命名模块。

Employee(int age) {
    if (age < 18) {
        throw new IllegalArgumentException("too young");
    }
    super(age);
}

可以校验参数、给无 初始化器 字段赋值；不能读字段、用 this、调实例方法、在 prologue return。有 初始化器 的字段不能提前赋值。

java -XX:+PrintFlagsFinal -version | grep UseCompactObjectHeaders
java -XX:+UseCompactObjectHeaders -jar app.jar

25 产品特性，默认 false。旧布局 96/128 位 → 64 位。依赖压缩类指针；关闭 UseCompressedClassPointers 会警告并禁用紧凑头。

java -XX:+UseShenandoahGC -XX:ShenandoahGCMode=generational -jar app.jar

JEP 521 只是把分代模式转为产品，默认仍是 satb。必须先选 ShenandoahGC，再显式指定 generational；不是默认 GC。

java -XX:AOTMode=record -XX:AOTConfiguration=app.aotconf -cp app.jar App
java -XX:AOTMode=create -XX:AOTConfiguration=app.aotconf -XX:AOTCache=app.aot -cp app.jar
java -XX:AOTCache=app.aot -cp app.jar App

JEP 514/515。改善启动与预热，不保证峰值吞吐；训练运行要覆盖真实路径，缓存与 JDK/平台绑定。