Trang chủ → Blog → Báo cáo lỗi chuẩn

Cách viết báo cáo lỗi (bug report) chuẩn cho app Android

7 phút đọc·VietTest Team·07/11/2026

Một bug report tốt không chỉ nói "app bị lỗi" — nó phải giúp developer tái hiện được trong 5 phút mà không cần hỏi lại bạn. Dưới đây là cấu trúc 6 thành phần mà đội VietTest dùng cho mọi ứng dụng đang được kiểm thử:

1. Tiêu đề ngắn gọn, chỉ rõ vấn đề

Tốt: [Cart] Nút “Đặt hàng” bị chặn khi mã giảm giá hết hạn
Không tốt: app không đặt hàng được

Quy tắc: [Tên màn hình/chức năng] — hành vi lỗi. Developer lọc theo màn hình, QA lọc theo chức năng — dùng cả hai.

2. Các bước tái hiện (Steps to reproduce)

1. Mở app (cold start), đăng nhập bằng [email protected].
2. Vào tab Giỏ hàng với 2 sản phẩm đã thêm.
3. Nhập mã giảm giá SALE10 (mã đã hết hạn) → bấm Áp dụng.
4. Bấm Đặt hàng → quan sát.

Luôn bắt đầu từ trạng thái xác định được: “cài mới”, “sau khi đăng nhập”, “sau khi khởi động lại thiết bị”. Nếu lỗi chỉ xảy ra ngẫu nhiên, ghi rõ tỉ lệ: “lặp lại 2/5 lần”.

3. Mong đợi vs Thực tế

Mong đợi: App hiển thị thông báo "Mã giảm giá đã hết hạn" và vẫn cho đặt hàng với giá gốc.
Thực tế:  Nút "Đặt hàng" bị disabled; không có thông báo; người dùng không biết phải làm gì.

4. Môi trường

• Thiết bị / OS: Pixel 6 / Android 15, build AP (build #123).
• Phiên bản app: v1.4.2 (versionCode 42).
• Mạng: Wi-Fi / 4G, điều kiện bình thường.
• Dữ liệu: tài khoản demo, không có phiên bản dữ liệu đặc biệt.

5. Logcat / bằng chứng

Chạy adb logcat *:E trong lúc tái hiện và đính kèm đoạn có E/ (Error). Nếu app crash, kèm cả stack trace. Một bug kèm log được ưu tiên xử lý hơn bug "không có bằng chứng".

6. Severity đúng chuẩn

Tham khảo khung S1–S4 trong VietTest: S1 (Slam Dunk) = crash/treo/mất dữ liệu; S2 (Three-Pointer) = tính năng chính hỏng; S3 (Field Goal) = lỗi thông thường; S4 (Free Throw) = lỗi nhỏ về UI/copy. Xem thêm: cách phân loại severity.

Checklist trước khi gửi

1. Tái hiện được ít nhất 2 lần với cùng điều kiện?
2. Tiêu đề đúng mẫu [Màn hình] — hành vi?
3. Steps, Expected/Actual, Environment đầy đủ?
4. Đã kiểm tra lỗi tương tự trong Lỗi đã biết của dự án?
5. Severity đúng; đã đính kèm log/screenshot?