java cds(类数据共享)是jvm启动优化技术,通过预生成并内存映射类归档文件,跳过解析、链接、验证等步骤,显著降低启动时间和内存占用,尤其适用于容器化、微服务冷启和ci/cd场景。

Java CDS 是什么,为什么现在还值得用
类数据共享(CDS)不是过时技术,而是 JVM 启动优化里少数能同时压低启动时间、减少内存占用的实招——尤其在容器化部署、微服务冷启、CI/CD 测试环境反复拉起 JVM 的场景下,效果直接可测。
它的核心逻辑很简单:java 在首次运行时把一堆基础类(rt.jar、modules-java.base 等)和你指定的自定义类 dump 成一个内存映像文件(shared archive),后续启动时直接 mmap 进内存,跳过解析、链接、验证等步骤。
容易踩的坑:JDK 10+ 默认启用 -XX:+UseSharedSpaces,但没生成 archive 就会静默退回到普通模式,不报错也不提示;JDK 17+ 还默认禁用 rt.jar 支持,必须用模块化方式构建 archive。
怎么生成并加载 CDS 归档文件(JDK 11+ 实操)
生成 archive 分两步:先预估类列表,再 dump。不能直接对生产 jar 包操作,必须用真实启动参数模拟一次类加载路径。
立即学习“Java免费学习笔记(深入)”;
- 用
-Xshare:dump前,先跑一次带-XX:+PrintSharedArchiveAndExit的启动,确认当前 JVM 支持共享空间 - 生成基础归档:
java -Xshare:dump -XX:SharedArchiveFile=./base.jsa(JDK 自带类) - 生成应用归档需先收集类列表:
java -XX:+UseAppCDS -XX:DumpLoadedClassList=classes.lst -cp myapp.jar MyApp,再用该列表构建:java -Xshare:dump -XX:SharedArchiveFile=./myapp.jsa -XX:SharedClassListFile=classes.lst -cp myapp.jar - 加载时必须显式指定:
java -Xshare:on -XX:SharedArchiveFile=./myapp.jsa -cp myapp.jar MyApp;-Xshare:on会失败退出,-Xshare:auto才是静默 fallback
注意:classes.lst 必须用同版本 JDK 生成,且 classpath 路径、JAR 时间戳、模块版本任何一项不一致,archive 就失效——CI 中建议把归档文件和 JDK 版本绑定发布。
CDS 归档失效的典型错误信息和排查点
最常遇到的不是报错,而是“没生效”:启动时间没变、RSS 内存没降、jstat -compiler 显示 loaded class 数量照旧。这时候要看三件事:
- 检查是否真加载了:
java -Xshare:on -XX:SharedArchiveFile=./myapp.jsa -XX:+PrintSharedArchiveAndExit -cp myapp.jar MyApp,输出里要有Shared archive is mapped和具体类数量 - 常见错误信息:
Unable to map shared archive(路径错/权限不足)、Shared archive file has wrong magic number(JDK 版本或构建参数不匹配)、Failed to map in SharedReadOnlySpace(Linux 上 ASLR 干扰,加-XX:+AlwaysPreTouch或关掉/proc/sys/kernel/randomize_va_space) - 使用
-verbose:class对比开启/关闭 CDS 时的类加载日志:如果[classload] java.lang.Object这类基础类仍显示 “loaded by” 而非 “shared objects file”,说明归档未命中
JDK 17+ 模块化 CDS 的关键变化
JDK 9 引入模块系统后,CDS 行为变了本质:不再支持 rt.jar,所有类必须通过 --module-path 或 --add-modules 显式声明;-XX:SharedClassListFile 列出的类必须已由模块解析器加载过。
- 不能再用
-cp+classes.lst传统方式;必须先用--describe-module确认目标类所属模块,再用--add-modules加载它 - 生成归档时要带上完整模块参数:
java --module-path mods --add-modules ALL-SYSTEM,my.app -Xshare:dump -XX:SharedArchiveFile=myapp.jsa -
java.base等系统模块归档仍可用 JDK 自带的base.jsa,但应用模块归档必须与模块图严格一致——换了个requires就得重做
模块化 CDS 的复杂度明显上升,但它换来的是更稳定的归档兼容性:只要模块签名不变,哪怕 class 文件微调(如 debug info 变更),archive 仍可复用。这点在频繁构建的流水线里反而更省心。










