Xử lý sự cố

Dịch vụ không chịu hoạt động (Vừa bật đã tắt)

Triệu chứng: Khi bạn nhấn nút chạy ▶, dịch vụ chuyển sang trạng thái ⟳ Đang khởi động... trong vài giây rồi lập tức quay về ○ Đã dừng.

Các nguyên nhân phổ biến và cách khắc phục nhanh:

Các bước tự chẩn đoán lỗi chuyên nghiệp:

1. Mở cửa sổ Service Watcher (nhấn nút 👁).
2. Lọc danh sách xem riêng dịch vụ đang bị lỗi.
3. Tìm các dòng sự kiện màu đỏ ERROR hoặc màu xám STOPPED gần nhất.
4. Đọc kỹ phần mô tả (Description), tại đây WinWraper đã ghi lại toàn bộ thông báo lỗi hệ thống giúp bạn biết chính xác dòng code nào đang bị lỗi.

⛔ Dịch vụ hiện trạng thái "Mất kết nối" (Circuit Open)

Khi một dịch vụ bị lỗi crash liên tiếp 5 lần trong vòng 60 giây, WinWraper sẽ tự động ngắt dịch vụ và hiện trạng thái ⛔ Mất kết nối (Circuit Open) để bảo vệ máy tính của bạn không bị treo đơ.

Lưu ý: Trạng thái "⛔ Mất kết nối" này chỉ mang ý nghĩa là "đã ngắt tự động khởi động lại để bảo vệ máy", hoàn toàn không phải do mất mạng Wi-Fi hay internet.

Cách xử lý:

1. Mở Service Watcher lên, tìm và sửa triệt để nguyên nhân gây crash trong code dự án của bạn.
2. Nhấp chuột phải vào dịch vụ đó → Chọn ↺ Restart. Dịch vụ sẽ tự động khôi phục chạy bình thường và đặt lại bộ đếm lỗi về 0.

⚠ Dịch vụ báo trạng thái "Thiếu đường dẫn" (Path Missing)

Triệu chứng: Dịch vụ vẫn nằm trong danh sách nhưng trạng thái hiện chữ màu cam: ⚠ Thiếu đường dẫn (Path Missing).

Nguyên nhân: Thư mục chứa dự án hoặc file chạy .exe của bạn đã bị bạn di chuyển sang ổ đĩa khác, đổi tên thư mục hoặc lỡ tay xóa mất trên máy tính.

Cách sửa:

• Vì WinWraper không có tính năng sửa trực tiếp đường dẫn để tránh xung đột cấu hình, cách sửa chuẩn xác và an toàn nhất là:
  1. Nhấp chuột phải vào dịch vụ lỗi → Chọn 🗑 Xóa service (yên tâm, file gốc của bạn không bị ảnh hưởng).
  2. Bấm nút ➕ Thêm service để đăng ký lại dịch vụ đó với đường dẫn thư mục mới chính xác.

WinWraper mở hai lần

Phần mềm chỉ cho phép duy nhất một cửa sổ chạy tại một thời điểm để tránh xung đột. Nếu bạn nhấp đúp vào biểu tượng ứng dụng ngoài màn hình mà không thấy cửa sổ nào hiện lên:

• Hãy nhìn xuống góc phải thanh công cụ của máy tính (System Tray), nhấp đúp vào biểu tượng WinWraper để mở lại cửa sổ chính.
• Hoặc nhấp chuột phải vào biểu tượng đó → Chọn 📋 Danh sách service.

Không kích hoạt được license

Kiểm tra:

• Có kết nối internet không?
• Email và key có đúng chính xác không? (kiểm tra khoảng trắng thừa)
• Key đã được dùng trên máy khác mà chưa deactivate chưa?

Nếu vẫn không được, liên hệ: ptdung91dev@hotmail.com

Windows Service không start sau khi boot

Nguyên nhân phổ biến:

• WinWraper service bị thiếu quyền chạy với account SYSTEM hoặc Local Service.
• Service phụ thuộc vào network/database chưa sẵn sàng khi boot.

Cách kiểm tra:

• Mở services.msc → tìm service của bạn → xem Event Log trong Properties.

Metrics không hiển thị dữ liệu

Nguyên nhân: Metrics chỉ bắt đầu ghi khi service đang chạy. Nếu service vừa mới start, cần đợi ít nhất 30 giây để có điểm dữ liệu đầu tiên.

Reset hoàn toàn WinWraper

Nếu WinWraper gặp sự cố nghiêm trọng:

1. Thoát WinWraper hoàn toàn (chuột phải tray → Exit).
2. Tìm thư mục dữ liệu: %APPDATA%\WinWraper\
3. Xoá file wraper-state.json để reset toàn bộ cấu hình service.

Liên hệ hỗ trợ

Nếu vấn đề vẫn còn sau khi thử các bước trên:

• Email: ptdung91dev@hotmail.com
• Website: boringtecvn.com

Tiếp theo: Tham chiếu nhanh →