Hiểu về nhật ký Minecraft

Nhật ký Minecraft là nguồn sự thật tốt nhất của bạn khi có sự cố. Chúng ghi lại những gì trò chơi hoặc máy chủ đã làm, theo thứ tự, cho đến tận thời điểm xảy ra lỗi. Hướng dẫn này giải thích những tệp nhật ký nào quan trọng, cách đọc một dòng nhật ký và những gì cần tìm.

Các tệp nhật ký quan trọng

Mọi thứ nằm trong thư mục logs/ (thư mục gốc máy chủ, hoặc instance/.minecraft trên máy khách):

  • latest.log
    Nhật ký đầy đủ của lần chạy hiện tại. Đây là tệp bạn mở đầu tiên; lỗi gần như luôn ở đây.
  • debug.log
    Một phiên bản chi tiết hơn nhiều của cùng lần chạy. Dùng nó khi latest.log không nói đủ.
  • Nhật ký lưu trữ
    Các lần chạy cũ hơn được nén dưới dạng 2026-06-08-1.log.gz. Giải nén nó để đọc một phiên trước đó.
  • crash-reports/
    Một thư mục riêng với một báo cáo tập trung, chỉ được ghi khi trò chơi gặp sự cố. Xem Cách đọc báo cáo sự cố Minecraft.

Cách đọc một dòng nhật ký

Mỗi dòng theo cùng một định dạng:

[14:23:51] [Server thread/ERROR]: Encountered an unexpected exception
  • [14:23:51]
    Dấu thời gian: khi nào sự kiện xảy ra.
  • [Server thread/ERROR]
    Luồng đã ghi nó, và cấp độ.
  • Thông báo
    Điều gì thực sự đã xảy ra, thường theo sau là một stack trace nếu đó là lỗi.

Cấp độ nhật ký cho bạn biết mức độ nghiêm trọng chỉ trong nháy mắt: INFO (bình thường), WARN (có gì đó không ổn nhưng không nghiêm trọng), ERROR (một lỗi thực sự), và FATAL (máy chủ đang tắt).

Luồng: ai đang nói

  • Server thread / main
    Vòng lặp trò chơi chính. Lỗi ở đây thường ảnh hưởng trực tiếp đến lối chơi (và có thể làm sập máy chủ).
  • Worker / IO threads
    Công việc nền như I/O chunk. Hữu ích cho các vấn đề về đĩa và lưu thế giới.
  • Mod/plugin threads
    Được đặt tên theo một mod hoặc plugin: một gợi ý nhanh về cái gì chịu trách nhiệm.

Những gì cần tìm

  1. Cuộn đến dòng ERROR/FATAL hoặc Exception đầu tiên; các lỗi sau đó thường chỉ là hệ quả của nó.
  2. Đọc phần khởi động để tìm mod/plugin lỗi, phiên bản Java sai hoặc EULA chưa được chấp nhận.
  3. Để ý spam WARN lặp lại như «Can't keep up!» (hiệu năng, xem Can't Keep Up) hoặc «moved too quickly».
  4. Ghi lại các dòng cuối trước khi treo hoặc tắt: chúng cho thấy máy chủ đang làm gì khi nó chết.
  5. Đối chiếu mọi lỗi với Sự cố thường gặp danh sách để có giải pháp chính xác.

Nhật ký máy chủ so với nhật ký máy khách

Chúng dùng chung định dạng nhưng nằm ở những nơi khác nhau. Nhật ký máy chủ ghi việc lưu thế giới, kết nối của người chơi và việc tải plugin/mod; nhật ký máy khách ghi việc kết xuất, gói tài nguyên và kết nối của chính bạn. Khi khắc phục sự cố tham gia, hãy so sánh cả hai: nguyên nhân có thể chỉ ở một phía.

Chia sẻ nhật ký một cách an toàn

Nhật ký có thể chứa IP máy chủ của bạn và đôi khi token, vì vậy đừng dán chúng công khai mà không xem trước. Dùng một dịch vụ paste (như mclo.gs) để chia sẻ, hoặc tải tệp trực tiếp lên MCDoctor.ai, nơi đọc nhật ký và giải thích nguyên nhân cùng giải pháp cho bạn, không cần đào bới thủ công.

Câu hỏi thường gặp

Trong thư mục logs/ ở thư mục gốc máy chủ của bạn hoặc thư mục instance/.minecraft. Lần chạy hiện tại là latest.log; các lần chạy cũ hơn là các tệp .log.gz đã nén.

Chúng bao quát cùng một lần chạy, nhưng debug.log chi tiết hơn nhiều. Bắt đầu với latest.log và chỉ chuyển sang debug.log khi bạn cần thêm chi tiết.

WARN nghĩa là có điều gì đó không ổn nhưng không nghiêm trọng; ERROR là một lỗi thực sự; FATAL nghĩa là máy chủ đang tắt. Tập trung vào dòng ERROR/FATAL đầu tiên.

Có, hãy tải lên latest.log hoặc một báo cáo sự cố và MCDoctor.ai sẽ phân tích nó rồi trả về nguyên nhân có khả năng nhất và cách khắc phục được đề xuất.