Skip to content
Hosting · Phân tích lỗi

NoClassDefFoundError

Plugin yêu cầu một class bị thiếu: thiếu dependency, file jar không đầy đủ và xung đột giữa các phiên bản thư viện.

Cập nhật 13 tháng 8, 2026

java.lang.NoClassDefFoundError: me/clip/placeholderapi/PlaceholderAPI

Đoạn code tham chiếu đến một lớp không tồn tại trong môi trường đang chạy.

Nguyên nhân

  1. Chưa cài thư viện phụ thuộc. Trong ví dụ trên, PlaceholderAPI bị thiếu — PlaceholderAPI. Tên gói trong thông báo lỗi gần như luôn chỉ ra plugin bạn cần: me/clip/placeholderapi → PlaceholderAPI, net/milkbowl/vault → Vault, com/comphenix/protocol → ProtocolLib.
  2. Đã cài thư viện phụ thuộc nhưng phiên bản quá cũ: lớp đó chỉ xuất hiện ở phiên bản mới hơn.
  3. Tệp jar bị hỏng: tệp chưa tải xong hoàn toàn.
  4. Plugin được build cho một core khác và tham chiếu đến những lớp bạn không có — Khả năng tương thích.

Cần làm gì

  1. Xác định thư viện từ tên gói.
  2. Cài đặt hoặc cập nhật thư viện đó — Vault, ProtocolLib.
  3. Tải lại tệp plugin nếu bạn không chắc về tính toàn vẹn của nó.
  4. Kiểm tra thứ tự: thư viện phụ thuộc phải được tải trước — điều này thường diễn ra tự động nếu nó được khai báo trong plugin.yml.

Các lỗi tương tự

ClassNotFoundException — lỗi tương tự ở bước tra cứu lớp. NoSuchMethodError — lớp tồn tại nhưng phương thức đã biến mất: do lệch phiên bản — NoSuchMethodError.

Hosting MinecraftMáy chủ của bạn chạy khi bạn offlineTạo máy chủ