Cheat Sheet — Maven 3.9 cho dự án Spring Boot

Vòng đời build Maven 3.9, các lệnh chạy test/chọn module/profile thường dùng, và khác biệt quan trọng giữa -DskipTests với -Dmaven.test.skip=true, verify với install.

Module 12

Vòng đời build (default lifecycle)

Vòng đời build (default lifecycle)
MụcÝ nghĩa & cách dùng
validate → compile → test-compile → test → package → verify → install → deployThứ tự các phase chính: gọi một phase sẽ chạy mọi phase trước nó. package đóng gói jar/war vào target/, verify chạy thêm kiểm tra tích hợp và quality gate, install cài artifact vào local repository (~/.m2), deploy đẩy lên remote repository (Nexus/Artifactory).
mvn cleanXóa thư mục target/ để build lại từ trạng thái sạch — bước đầu tiên khi nghi ngờ artifact cũ gây lỗi khó hiểu. Thường ghép: mvn clean verify.
mvn verifyChạy trọn vòng đời tới verify: unit test, integration test và các kiểm tra gắn ở phase verify, nhưng không cài vào ~/.m2. Đây là lệnh kiểm chứng chuẩn trước khi commit và là lệnh CI thường chạy.
mvn installNhư verify nhưng cài thêm artifact vào local repository để module/dự án khác trên cùng máy dùng được. Khác verify ở điểm này — CI phát hành thường dùng deploy thay vì install.
mvn packageĐóng gói tới phase package: chạy unit test rồi tạo jar (Spring Boot jar thực thi được nhờ spring-boot-maven-plugin repackage) trong target/. Nhanh hơn verify khi chưa cần integration test và các kiểm tra ở phase verify.

Chạy & bỏ qua test

Chạy & bỏ qua test
MụcÝ nghĩa & cách dùng
mvn test -Dtest=PointsServiceTestChỉ chạy một class test chỉ định; nhiều class thì phân tách bằng dấu phẩy, hoặc -Dtest=PointsServiceTest#congDiem* để chạy theo mẫu tên method.
mvn verify -DskipTestsVẫn biên dịch test (test-compile chạy) nhưng không thực thi test. An toàn hơn khi chỉ muốn đóng gói nhanh mà vẫn chắc chắn code test còn biên dịch được.
mvn verify -Dmaven.test.skip=trueBỏ qua cả biên dịch lẫn chạy test — khác hẳn -DskipTests. Chỉ dùng khi thật cần vì code test hỏng sẽ không bị phát hiện cho tới lần build sau.

Module, profile & phụ thuộc

Module, profile & phụ thuộc
MụcÝ nghĩa & cách dùng
mvn verify -pl loyalty-api -amChỉ build module loyalty-api (-pl) cùng mọi module mà nó phụ thuộc (-am, also-make) trong dự án multi-module — tiết kiệm lớn so với build toàn bộ reactor.
mvn verify -rf :loyalty-apiChạy tiếp (resume-from) từ module loyalty-api trong reactor sau khi một lần build dài bị lỗi giữa chừng và đã sửa xong module gây lỗi.
mvn verify -PprodKích hoạt Maven profile tên prod khai báo trong pom.xml (có thể bật nhiều profile, phân tách bằng dấu phẩy). Phân biệt với Spring profile: Maven profile tác động lúc build, Spring profile tác động lúc chạy.
mvn dependency:treeIn cây phụ thuộc kèm phiên bản thực tế sau khi Maven phân giải xung đột — lệnh đầu tiên khi gặp lỗi lạ do trùng thư viện; thêm -Dincludes=org.springframework.boot để lọc theo nhóm.
mvn help:evaluate -Dexpression=project.version -q -DforceStdoutIn giá trị một thuộc tính/biểu thức của pom hiệu dụng — tiện để script CI lấy version hoặc kiểm tra property đã được profile ghi đè đúng chưa.
mvn dependency:analyzePhân tích phụ thuộc khai báo nhưng không dùng, và phụ thuộc đang dùng nhờ transitive mà chưa khai báo trực tiếp — dọn pom gọn và tránh vỡ build bất ngờ khi thư viện trung gian đổi cây phụ thuộc.

Mạng, tốc độ & chạy ứng dụng

Mạng, tốc độ & chạy ứng dụng
MụcÝ nghĩa & cách dùng
mvn verify -oChế độ offline: chỉ dùng local repository, không chạm mạng — build nhanh và tái lập được trên máy bay/CI cô lập, nhưng sẽ lỗi nếu thiếu artifact chưa từng tải.
mvn verify -UÉp kiểm tra bản cập nhật của SNAPSHOT và các release bị cache lỗi trên remote repository — dùng khi đồng đội vừa publish SNAPSHOT mới mà máy local vẫn giữ bản cũ.
mvn verify -T 1CBuild song song với số thread bằng số nhân CPU (1C = 1 thread mỗi core) cho dự án multi-module — rút ngắn thời gian build; module phải không phụ thuộc ẩn lẫn nhau mới an toàn.
mvn spring-boot:runChạy ứng dụng Spring Boot ngay từ mã nguồn qua Spring Boot Maven Plugin, không cần đóng gói trước — vòng lặp dev hằng ngày. Truyền cấu hình bằng -Dspring-boot.run.profiles=dev nếu cần.
mvn spring-boot:build-imageĐóng gói ứng dụng thành OCI image bằng Cloud Native Buildpacks qua Spring Boot Maven Plugin, không cần viết Dockerfile — hữu ích khi muốn image chuẩn nhanh; khi cần kiểm soát từng layer, dùng Dockerfile multi-stage với layered jar.
./mvnw verifyChạy qua Maven Wrapper: dùng đúng phiên bản Maven 3.9 mà dự án ghim trong .mvn/wrapper bất kể máy có cài Maven gì — đảm bảo mọi thành viên và CI build giống hệt nhau. Luôn ưu tiên ./mvnw thay vì mvn trên máy cá nhân.
./mvnw -vKiểm tra phiên bản Maven, phiên bản Java và thư mục JAVA_HOME mà build đang thực sự dùng — bước rà soát đầu tiên khi build trên máy mình khác CI, vì Maven chạy bằng JDK trỏ bởi JAVA_HOME chứ không hẳn JDK mặc định của shell.