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
- 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. - Đã 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.
- Tệp jar bị hỏng: tệp chưa tải xong hoàn toàn.
- 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ì
- Xác định thư viện từ tên gói.
- Cài đặt hoặc cập nhật thư viện đó — Vault, ProtocolLib.
- 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ó.
- 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ủ
