Đây là bài 2 trong phần 7 của chuỗi demo “Laravel đáng tin cậy: Từ request đến công việc nền”. Các quyết định về validation, phân quyền, transaction và queue trong ứng dụng quản lý học tập. Bài viết dùng ví dụ và dữ liệu giả để minh họa; hãy thử trên môi trường riêng trước khi áp dụng vào dự án.
Mục tiêu cụ thể
Queue tách công việc chậm khỏi request. Job cần xử lý retry, timeout và tác dụng phụ để không gửi thông báo hoặc tạo tài nguyên trùng.
Tình huống lỗi
Dispatch trước khi transaction commit có thể khiến worker chưa thấy dữ liệu. Retry phải được thiết kế từ đầu, không chỉ tăng số lần thử.
Chẩn đoán có bằng chứng
Trong bài queue và công việc nền, hãy cố ý tái hiện tình huống trên ở môi trường thử nghiệm. Mục tiêu là thấy vì sao kết quả sai và thu thập đủ bằng chứng để phân biệt lỗi dữ liệu, lỗi quy tắc và lỗi cấu hình. Không sửa đồng thời nhiều yếu tố vì bạn sẽ khó xác định nguyên nhân.
- Ghi rõ bước thao tác và kết quả mong đợi.
- Thu nhỏ ví dụ đến mức vẫn tái hiện được lỗi.
- Đối chiếu dữ liệu thực với giả định ban đầu.
- Đặt giả thuyết và thay đổi một yếu tố.
- Xác nhận bằng cách tái chạy ví dụ tối thiểu.
Mẫu đối chiếu
SendCourseWelcome::dispatch($enrollment->id)->afterCommit();
// Trong job, đọc lại enrollment theo ID,
// kiểm tra trạng thái và dùng khóa duy nhất
// cho từng thông báo cần gửi.Kiểm tra sau sửa
- Job chỉ chạy sau commit
- Có chiến lược retry rõ ràng
- Không gửi trùng khi chạy lại
Khi lỗi biến mất, thực hiện lại yêu cầu gốc: Thiết kế job gửi thông báo sau đăng ký học; mô phỏng lỗi tạm thời và việc chạy lại cùng job. Sau đó thử trường hợp đầu vào rỗng hoặc trạng thái chưa được khởi tạo nếu phù hợp. Một bản sửa phải khôi phục hành vi đã định nghĩa, không chỉ làm mất thông báo lỗi.
Ghi chú bàn giao
Viết báo cáo ngắn gồm nguyên nhân, phạm vi ảnh hưởng, thay đổi và cách kiểm chứng. Nếu chưa xác định được nguyên nhân, ghi rõ điều còn chưa biết và phép kiểm tra tiếp theo, không biến giả thuyết thành kết luận.