Sau hướng dẫn này
Bạn phân loại được lỗi code, cấu hình, kết nối và giới hạn tài nguyên.
Bắt đầu từ triệu chứng
| Triệu chứng | Xem ở đâu | Việc tiếp theo |
|---|---|---|
| Không thấy repository | Source / tài khoản GitHub | Kiểm tra quyền repo, tài khoản kết nối và branch; hoặc upload ZIP hợp lệ. |
| Install/build thất bại | Build logs của release lỗi | Đọc lỗi đầu tiên; kiểm tra lockfile, runtime, đường dẫn source và lệnh build. Chạy cùng lệnh tại máy cá nhân. |
| Build xong nhưng app dừng | Runtime logs | Kiểm tra start command, biến bắt buộc và lỗi kết nối database. |
| 502 / timeout / không có phản hồi | Runtime logs và public port | Đảm bảo app lắng nghe 0.0.0.0, cổng đúng với Console, tiến trình còn chạy; thử URL project trước domain riêng. |
| Database access denied | Connection và env app | Đối chiếu host/port/user/password/database. localhost trong app deploy không phải database managed. |
| Database timeout | Endpoint/mạng và metrics | Kiểm tra endpoint truy cập được từ app, yêu cầu TLS và giới hạn kết nối; dùng pool phù hợp. |
| Sửa env nhưng app dùng giá trị cũ | Environment và release đang chạy | Áp dụng/redeploy và kiểm tra lại; biến frontend có thể cần build lại. |
| App chậm hoặc hết RAM | CPU/RAM, DB/Redis usage | Kiểm tra truy vấn, cache, số kết nối và memory leak; đo lại trước khi tăng plan. |
| Redis client/queue báo command bị chặn | Command reference | Đối chiếu command thư viện sử dụng; không mặc định mọi thư viện queue tương thích. |
Khi lỗi xuất hiện sau release mới
- Ghi lại release/commit và thời điểm bắt đầu lỗi; so sánh thay đổi code, env và schema.
- Nếu cần rollback, chọn phiên bản ổn định đã biết và kiểm tra tương thích dữ liệu trước.
- Sau thao tác, mở URL và thử lại chức năng bị lỗi; theo dõi logs và metrics để xác nhận app đã phục hồi.
Gửi thông tin để được hỗ trợ nhanh
Chuẩn bị project/service ID, release ID, thời điểm kèm múi giờ, thông báo lỗi, bước tái hiện và kết quả mong đợi. Che mật khẩu, token và dữ liệu khách hàng trước khi gửi logs hoặc ảnh. Không gửi toàn bộ file .env.