Cách đọc báo cáo sự cố Minecraft

Minecraft ghi một báo cáo sự cố mỗi khi trò chơi hoặc máy chủ dừng đột ngột. Hãy xem ở đây:

• crash-reports/
  Một tệp có dấu thời gian như crash-2026-06-08_14.23.51-server.txt. Đây là báo cáo chuyên dụng, chi tiết.
• logs/latest.log
  Nhật ký chạy đầy đủ. Nếu không có báo cáo sự cố (tiến trình chỉ thoát), lỗi nằm ở đây, dưới cùng.
• logs/debug.log
  Một nhật ký chi tiết hơn nhiều, hữu ích khi latest.log không đủ chi tiết.

Trên máy chủ, các thư mục này nằm trong thư mục gốc của máy chủ; trên máy khách, chúng nằm trong thư mục instance/.minecraft. Luôn mở tệp mới nhất theo dấu thời gian.

Mỗi báo cáo có các phần giống nhau, từ trên xuống dưới:

• Tiêu đề và mô tả
  Một dòng Description một dòng tóm tắt điều gì đã thất bại, cùng thời gian. Đây là manh mối đầu tiên của bạn.
• Stack trace
  Loại ngoại lệ, sau đó là danh sách các dòng mã cho biết nơi nó xảy ra, thường theo sau là một hoặc nhiều khối Caused by: .
• Cấp độ / chi tiết bị ảnh hưởng
  Đối với sự cố thế giới hoặc thực thể: tọa độ, chiều và thực thể/khối liên quan.
• Chi tiết hệ thống
  Phiên bản Minecraft, phiên bản Java, bộ nhớ được cấp, trình tải mod và toàn bộ danh sách mod. Vàng ròng cho việc chẩn đoán.

1. Đọc dòng Description. Đó là một bản tóm tắt bằng ngôn ngữ đơn giản, ví dụ «Exception ticking entity» hoặc «Unexpected error». Điều đó đã cho bạn biết danh mục.
2. Tìm loại ngoại lệ ở đầu stack trace (ví dụ java.lang.OutOfMemoryError, NullPointerException, NoClassDefFoundError). Loại thường nêu thẳng tên vấn đề.
3. Nhảy đến «Caused by:» cuối cùng. Khi có nhiều cái được nối chuỗi, cái sâu nhất thường là nguyên nhân gốc thực sự, không phải cái đầu tiên.
4. Tìm một tên mod hoặc plugin trong đường dẫn gói (ví dụ com.somemod.Thing). Điều đó chỉ thẳng vào thủ phạm. Một stack trace thuần net.minecraft.* thay vào đó chỉ tới dữ liệu vanilla/thế giới.
5. Kiểm tra chi tiết hệ thống. Xác nhận phiên bản Java khớp với phiên bản Minecraft của bạn, xem bao nhiêu bộ nhớ đã được cấp, và quét danh sách mod để tìm bản trùng lặp hoặc mục lỗi thời.
6. Khớp triệu chứng với một giải pháp đã biết. Dùng nguyên nhân bạn tìm thấy để chuyển đến giải pháp tương ứng (xem các ví dụ bên dưới).

• OutOfMemoryError: Java heap space
  Không đủ bộ nhớ. Xem Out of Memory.
• Exception ticking entity
  Một thực thể bị hỏng duy nhất. Xem Ticking Entity.
• A single server tick took 60.00 seconds
  Máy chủ bị treo. Xem Watchdog Crash.
• NoClassDefFoundError / ClassNotFoundException
  Một thư viện bị thiếu. Xem NoClassDefFoundError.
• Exit code -1 with no crash report
  Hãy đọc latest.log thay vào đó. Xem Error Code -1.

Duyệt tất cả chúng trên trang Sự cố thường gặp .

Đôi khi tiến trình chỉ thoát (thường với mã thoát 1 hoặc -1) mà không ghi báo cáo sự cố. Trong trường hợp đó, lỗi thực sự nằm ở dưới cùng của logs/latest.log. Cuộn từ cuối lên đến dòng ERROR, FATAL hoặc Exception đầu tiên: đó là nơi mọi thứ trở nên sai. Để hiểu chính định dạng nhật ký, hãy xem Hiểu về nhật ký Minecraft.