Project tạo bằng Cursor, Lovable hay Bolt không chạy? Bắt đầu từ đâu

Ghi chú minh bạch: bài này là bản tóm tắt/dịch từ một hướng dẫn trên blog của tôi, thực hiện với sự hỗ trợ của AI. Hướng dẫn đầy đủ kèm FAQ được liên kết ở cuối bài.

Câu trả lời ngắn gọn: đừng tiếp tục yêu cầu AI "sửa" theo vòng lặp. Hãy kiểm tra log, biến môi trường và trạng thái deploy, rồi thu hẹp vấn đề trước khi thay đổi code.

Những nguyên nhân điển hình khiến project do AI tạo ra bị hỏng

Khi một project tạo bằng Cursor, Lovable hay Bolt gặp lỗi, nguyên nhân gần như luôn là một trong năm điều sau:

1. Lỗi chưa được đọc. Mở console của trình duyệt và log server. Thông báo lỗi thường cho biết chính xác cái gì bị hỏng. Dán nguyên văn lỗi vào chat thay vì mô tả triệu chứng.
2. Biến môi trường. Chạy được ở local nhưng hỏng khi deploy? Thường là API key hoặc URL chưa có trong môi trường runtime. Đây là kiểu "5 phút trước vẫn chạy".
3. Cập nhật dependency. Một package vừa cập nhật có thể đã phá vỡ thứ gì đó. Trước khi động vào bất cứ thứ gì khác, kiểm tra xem gần nhất cái gì đã thay đổi.
4. Mất ngữ cảnh. Sau nhiều lần "sửa giúp tôi", model bắt đầu thêm code mâu thuẫn với code nó đã viết trước đó. Quay lại commit chạy được gần nhất và chỉ yêu cầu một thay đổi nhỏ mỗi lần.
5. Nợ kiến trúc. Nếu mọi thứ nằm trong một file, bất kỳ sửa chữa nào cũng phá vỡ thứ khác. Lúc này, refactor quan trọng hơn tính năng mới.

Thứ tự debug

Nguyên văn thông báo lỗi → biến môi trường → thay đổi gần nhất → tái hiện tối thiểu. Trong chat với AI, đưa log và lỗi gốc luôn nhanh hơn mô tả triệu chứng.

Hướng dẫn đầy đủ (kèm FAQ, tiếng Anh): https://ofershap.github.io/en/posts/vibe-code-project-rescue/ Blog (tiếng Anh): https://ofershap.github.io/en/