Spring Boot bài 10: Validation và BindingResult: báo lỗi ngay trên biểu mẫu
- 18-10-2026
- Toanngo92
- 0 Comments
Giáo trình Spring Boot MVC và REST API · Chương 5/12: Biểu mẫu, validation và điều hướng · Bài 10/28 · Biên soạn tháng 10/2026.
Mục lục
Mục tiêu bài học
Kiểm tra dữ liệu phía server, trả lỗi theo trường và giữ nguyên nội dung người dùng đã nhập.
Ràng buộc HTML chưa đủ
required, maxlength và min giúp người dùng nhập thuận tiện, nhưng request có thể được gửi từ công cụ khác hoặc sửa trong trình duyệt. Server phải tự kiểm tra dữ liệu trước khi ghi database. CourseForm dùng Jakarta Bean Validation, không dựa vào nhãn hướng dẫn hoặc JavaScript để xác định giới hạn thật.
Tên không được trống và tối đa 120 ký tự; giá bắt buộc, không âm, tối đa 10 chữ số phần nguyên và 2 chữ số thập phân; categoryId bắt buộc và dương. Các giới hạn này được chọn phù hợp với cột DECIMAL(12,2) và VARCHAR(120), tránh chuyện UI nhận được nhưng DB lại cắt hoặc từ chối.
Tệp trong mã nguồn mẫu: src/main/java/com/hocvietcode/academy/CourseForm.java. Đoạn dưới được trích từ tệp này; xem bản tải về để có đủ import và phần còn lại.
package com.hocvietcode.academy;
import jakarta.validation.constraints.*;
import java.math.BigDecimal;
public class CourseForm {
@NotBlank(message="Vui lòng nhập tên") @Size(max=120) private String title;
@NotNull @DecimalMin("0.00") @DecimalMax("9999999999.99") @Digits(integer=10,fraction=2) private BigDecimal price;
@NotNull @Positive private Long categoryId;
public String getTitle(){return title;} public void setTitle(String title){this.title=title;}
public BigDecimal getPrice(){return price;} public void setPrice(BigDecimal price){this.price=price;}
public Long getCategoryId(){return categoryId;} public void setCategoryId(Long id){this.categoryId=id;}
}
Đặt BindingResult ngay sau đối tượng được kiểm tra
@Valid yêu cầu kiểm tra CourseForm sau khi bind. BindingResult phải đứng ngay sau tham số form tương ứng để Controller chủ động xử lý các lỗi binding và validation. Nếu có lỗi, trả lại template cùng model hiện tại thay vì redirect sang trang trống.
Danh sách danh mục và action cần được thêm lại khi trả form lỗi. Các th:errors hiển thị thông báo theo trường; lỗi nghiệp vụ như danh mục không tồn tại được thêm dưới dạng global error. Người dùng không phải nhập lại tất cả chỉ vì một trường sai.
Tệp trong mã nguồn mẫu: src/main/java/com/hocvietcode/academy/CourseWebController.java. Đoạn dưới được trích từ tệp này; xem bản tải về để có đủ import và phần còn lại.
@PostMapping("/admin/courses") String create(@Valid @ModelAttribute("form") CourseForm form,BindingResult errors,Model model,RedirectAttributes flash){
if(!errors.hasErrors())try{service.create(form);}catch(IllegalArgumentException e){errors.reject("invalid",e.getMessage());}
if(errors.hasErrors()){model.addAttribute("action","/admin/courses");model.addAttribute("categories",service.categories());return "courses/form";}
flash.addFlashAttribute("message","Đã thêm khóa học");return "redirect:/courses";
}
Validation cú pháp và kiểm tra nghiệp vụ
@NotNull chỉ chứng minh có categoryId, không chứng minh danh mục tồn tại. @DecimalMin chỉ kiểm tra giá trị, không quyết định tài khoản nào được sửa giá. Validation kiểm tra hình dạng và giới hạn đầu vào; Service xử lý quy tắc liên quan dữ liệu; Security xử lý quyền. Ba lớp đó bổ sung cho nhau.
Trong ví dụ, IllegalArgumentException từ Service được đổi thành thông báo toàn form. Không bắt Exception chung rồi hiển thị nguyên e.getMessage() cho mọi lỗi: lỗi SQL hoặc kết nối không phải thông báo phù hợp cho người dùng. Lỗi hệ thống cần ghi log và phản hồi có kiểm soát.
Kiểm tra các ca biên
Thử tên chỉ gồm khoảng trắng, giá -1, giá có ba chữ số sau dấu thập phân, danh mục để trống và một categoryId không tồn tại. Sau mỗi lần, trang phải giữ nội dung đã nhập, có thông báo đúng và không thêm bản ghi. Sau khi sửa đúng dữ liệu, request mới được lưu và chuyển trang.
CourseService cũng kiểm tra một số bất biến trong entity, vì nó có thể được gọi từ nơi khác ngoài form HTTP. Điều đó không thay thế @Valid; nó giữ cho đối tượng nghiệp vụ không dễ rơi vào trạng thái sai. Bài kiểm thử sẽ xác nhận cả response và số bản ghi để tránh “có báo lỗi nhưng vẫn lưu”.
Lỗi thường gặp và lưu ý
- @Size không tự cấm null; cần kết hợp ràng buộc bắt buộc phù hợp.
- Không redirect khi form sai nếu chưa có cơ chế bảo toàn dữ liệu và lỗi; trả template thường đơn giản hơn.
Ghi nhớ
Validation hữu ích khi người dùng biết sai ở đâu và dữ liệu chưa bị lưu. Giới hạn UI, server và database phải thống nhất.

