迁移到 JDK 8

先确认版本坐标01

JDK 8 的 class 文件版本是 52，默认 GC 是 Parallel（服务端模式），PermGen 已被 Metaspace 取代，Java EE 模块仍在 JDK 里。升级前先把源码、编译工具、运行时、依赖四者的版本对齐。

java -version
javac -version
javap -verbose App.class | findstr major
# Linux / macOS: javap -verbose App.class | grep major

  major version: 52

UnsupportedClassVersionError 会直接给出 class 文件版本，例如 class file version 52.0。它说明运行应用的 JDK 比编译时使用的 JDK 旧，或者依赖里有更高版本编译的 jar。

-source / -target 与真正的 API 边界02

JDK 8 的 javac 没有 --release（9 才加入）。-source 1.7 只限制语法和字节码版本，不会检查你用了哪些 API；真正的 7 API 边界要靠 -bootclasspath 指向 7 的 rt.jar。

import java.util.Arrays;
import java.util.List;

public class Source7Demo {
    public static void main(String[] args) {
        List<String> names = Arrays.asList("Ada", "Alan");
        names.forEach(n -> System.out.println(n));
    }
}

javac -source 1.7 -target 1.7 Source7Demo.java

Source7Demo.java:7: error: lambda expressions are not supported in -source 1.7
        names.forEach(n -> System.out.println(n));
                        ^
  (use -source 8 or higher to enable lambda expressions)

这个报错只说明语法不兼容。如果把 Lambda 改回匿名类，仍可能因为调用了 8 才有的 API 而在 7 上运行失败；-source 不会帮你检查这一点。

PermGen → Metaspace：参数要清理03

PermGen 在 JDK 8 被移除，-XX:MaxPermSize 不再生效；JVM 会打印警告并继续启动。类元数据改放在 Metaspace，使用本地内存，不再受堆大小限制。

java -XX:MaxPermSize=256m -version

Java HotSpot(TM) 64-Bit Server VM warning: ignoring option MaxPermSize=256m; support was removed in 8.0

Metaspace 默认没有上限，受本机内存限制；可以用 -XX:MetaspaceSize 设置首次 GC 的高水位，用 -XX:MaxMetaspaceSize 设置硬上限。CompressedClassSpaceSize 限制压缩类指针区域。

二进制兼容与工具链04

default 方法让接口可以在不破坏实现类的情况下演进，这是 JDK 8 能向 Collection 添加 stream() 的前提。但二进制兼容有边界：新增抽象方法、父类同签名方法返回类型冲突、以及未更新字节码库，都可能出问题。

• ASM / CGLIB / Javassist 等字节码库必须能识别 class 52；旧版本会报 Unsupported class file major version 52。
• 编译期用 -source 1.8，运行期至少 8；混用 7 编译的依赖通常没问题。
• Nashorn 在 8 是正式引擎；JDK 11 弃用、15 移除，不要把新代码绑死在 nashorn 上。
• java.time 与 Date/Calendar 可以互转，但 java.sql.Date.toInstant() 在 8 抛 UnsupportedOperationException。
• IDE、Maven/Gradle、CI、容器镜像必须一起指向 8，否则本地能编译、线上仍可能跑在 7 上。

default 方法冲突的典型报错是 class C inherits unrelated defaults for m() from types A and B；必须在类里覆盖，并用 A.super.m() 或 B.super.m() 选择。

升级检查清单05

1. 统一 JDK 与构建工具：IDE、Maven/Gradle、CI、容器镜像都指向 8。
2. 删除 -XX:MaxPermSize、-XX:PermSize 等 PermGen 参数，改用 Metaspace 参数。
3. 升级 ASM/CGLIB/字节码插件，确认支持 class 52。
4. 清理 -source 1.7 / -target 1.7，至少改成 1.8。
5. 跑一遍 default 方法冲突检查，尤其是实现多个接口的类。
6. 先迁日期 API，再逐步用 Lambda/Stream 替换匿名类和循环。

迁移完成的标准不是「能启动」，而是「启动参数干净、依赖支持 class 52、测试通过、回滚路径明确」。

版本边界BOUNDARY

这张表比 API 本身更值得记。写代码时先确认你的运行时版本。

费曼自检SELF CHECK

先合上页面，用自己的话回答，再展开对照。能讲出因果和反例，才算真正掌握。