Cheat Sheet — JVM Flags cho Java 21 trong Container
Các flag JVM quan trọng khi chạy Spring Boot trên Java 21 trong container: sizing heap theo RAM limit, chọn GC (G1/ZGC), log GC, heap dump, JFR và truyền cấu hình qua biến môi trường.
Module 08
Heap & nhận diện container
Heap & nhận diện container
Mục
Ý nghĩa & cách dùng
-Xms512m
Kích thước heap ban đầu. Trong container thường đặt bằng -Xmx (ví dụ qua tỉ lệ RAM) để JVM không phải co giãn heap và tránh bị OOM kill bất ngờ khi heap phình muộn.
-Xmx2g
Kích thước heap tối đa tuyệt đối. Trong container nên ưu tiên cách tính theo tỉ lệ RAM (Initial/MaxRAMPercentage) hơn là ghim cứng -Xmx, vì limit thay đổi theo môi trường deploy.
-XX:InitialRAMPercentage=50
Heap ban đầu bằng 50% RAM mà JVM nhìn thấy (trong container là memory limit nếu UseContainerSupport bật). Thay cho -Xms khi sizing theo tỉ lệ.
-XX:MaxRAMPercentage=75
Heap tối đa bằng 75% RAM limit — chừa phần còn lại cho metaspace, thread stack, direct buffer và bộ nhớ native khác. Đây là cách sizing heap phổ biến cho Spring Boot trong container.
-XX:+UseContainerSupport
JVM đọc CPU/memory limit của container (cgroup) để tính heap và số thread GC/JIT. Flag này bật mặc định từ JDK 10+ trên Linux, chỉ cần ghi rõ để tài liệu hóa khi cần.
Chọn & tinh chỉnh Garbage Collector
Chọn & tinh chỉnh Garbage Collector
Mục
Ý nghĩa & cách dùng
-XX:+UseG1GC
Chọn G1 GC — GC mặc định của JVM trên máy nhiều nhân/heap lớn, cân bằng throughput và pause. Là lựa chọn an toàn mặc định cho đa số service Spring.
-XX:+UseZGC
Chọn ZGC — GC có pause rất thấp (dưới mili-giây) và gần như không tăng theo kích thước heap; trên Java 21, ZGC thế hệ mới (generational) dùng thêm -XX:+ZGenerational. Phù hợp khi độ trễ đuôi (p99) là ưu tiên số một.
-XX:MaxGCPauseMillis=200
Mục tiêu mềm cho thời gian pause tối đa của G1: GC tự điều chỉnh vùng nhớ/chu kỳ để hướng tới mục tiêu này — đây là mục tiêu phấn đấu, không phải giới hạn cứng.
Unified logging của Java 21: ghi log GC (mọi tag bắt đầu bằng gc) ra file có xoay vòng. Dùng để phân tích pause và hành vi GC sau sự cố thay vì đoán.
-XX:+HeapDumpOnOutOfMemoryError
Tự chụp heap dump khi JVM gặp OutOfMemoryError để phân tích offline bằng công cụ như Eclipse MAT/jhat.
-XX:HeapDumpPath=/var/log/app/heapdump.hprof
Nơi ghi file heap dump. Trong container, trỏ tới volume/PVC còn trống đủ lớn — heap dump có kích thước xấp xỉ heap.
-XX:+ExitOnOutOfMemoryError
Thoát tiến trình ngay khi OutOfMemoryError xảy ra thay vì để ứng dụng chạy tiếp trong trạng thái hỏng; orchestrator (Kubernetes) sẽ khởi động lại pod sạch.
Bật Java Flight Recorder ngay từ lúc khởi động, ghi ra file .jfr để mở bằng JDK Mission Control. JFR tích hợp sẵn trong JDK 21, overhead thấp, dùng được trên production.
Kích hoạt JFR trên tiến trình JVM đang chạy mà không cần khởi động lại — cách lấy dữ liệu profiling ngay giữa sự cố.
jcmd <pid> VM.native_memory summary
Xem phân bổ bộ nhớ native (metaspace, thread, code cache, direct...) — điều kiện tiên quyết là JVM được khởi động với -XX:NativeMemoryTracking=summary.
-XX:NativeMemoryTracking=summary
Bật theo dõi bộ nhớ native ở mức summary (overhead nhỏ) để khi RSS vượt heap vẫn truy được phần native nào đang phình.
Truyền flag & cấu hình qua môi trường
Truyền flag & cấu hình qua môi trường
Mục
Ý nghĩa & cách dùng
JDK_JAVA_OPTIONS
Biến môi trường được launcher java của JDK 9+ tự đọc và tiền tố vào dòng lệnh — tiện để tiêm flag JVM trong container mà không sửa ENTRYPOINT. Giá trị của nó được áp dụng trước các đối số dòng lệnh.
JAVA_TOOL_OPTIONS
Biến môi trường được mọi tiến trình JVM tự đọc khi khởi động (kể cả khi chạy qua công cụ khác). Mạnh nhưng dễ gây bất ngờ vì áp dụng cho mọi JVM trong container; chỉ dùng khi thật cần và ghi chú rõ.
-Dspring.profiles.active=prod
System property kích hoạt profile Spring khi khởi động (tương đương --spring.profiles.active=prod hoặc biến SPRING_PROFILES_ACTIVE). Quyết định bean @Profile và file cấu hình application-prod.yml nào được nạp.
--add-opens java.base/java.util=ALL-UNNAMED
Mở một package của module JDK cho code không module truy cập reflective — chỉ cần khi thư viện cũ dùng reflection sâu vào nội bộ JDK và bị InaccessibleObjectException trên Java 21. Thêm từng gói cụ thể theo lỗi thực tế, không mở tràn lan.