Bài đọc

Request, route và controller: tình huống lỗi và cách chẩn đoán

3 phút đọc

Đây là bài 4 của chương 1: Request, route và controller, thuộc khóa demo Laravel Backend. Nội dung được dùng để trải nghiệm cấu trúc chương trình học; hãy thực hành trên dữ liệu và môi trường thử nghiệm riêng. Trong dự án xuyên suốt, bạn sẽ xây dựng backend quản lý khóa học, bài học và tiến độ học tập.

Mục tiêu cụ thể

Một request đi qua middleware, route và controller trước khi tạo response. Controller nên điều phối thay vì chứa toàn bộ quy tắc nghiệp vụ.

Tình huống lỗi

Trả toàn bộ model có thể lộ trường không dành cho client. Sử dụng resource hoặc cấu hình trường được phép hiển thị.

Chẩn đoán có bằng chứng

Trong bài request, route và controller, 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

Route::get("/courses", [CourseController::class, "index"]);

public function index()
{
    return Course::query()->where("status", "published")->paginate(12);
}

Kiểm tra sau sửa

Không trả bản nháp
Có phân trang
Không lộ trường nội bộ

Khi lỗi biến mất, thực hiện lại yêu cầu gốc: Thiết kế endpoint liệt kê khóa học đã xuất bản với phân trang và cấu trúc response nhất quán. 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