CAFORADocs
故障排除

插件錯誤

排查並修復 Cafora Minecraft 伺服器上的插件錯誤。

圖文操作步驟

截圖使用目前應用程式介面與示範資料。請按自己的服務資料操作,點擊圖片可檢視原圖。

檢查控制檯

開啟 Essentials → Console / 常用 → 控制檯,先檢視狀態、啟動輸出和錯誤。連線遊戲前等待 Done 或對應軟體的就緒提示。

檢查控制檯
檢查控制檯2026-11-11 · 目前應用程式介面 · 示範資料 · 開啟原圖檢視

找到檔案日誌

在檔案中雙擊 logs 並找到 latest.log,核對修改時間。在重啟覆蓋或輪換日誌前儲存相關檔案。

找到檔案日誌
找到檔案日誌2026-11-11 · 目前應用程式介面 · 示範資料 · 開啟原圖檢視

閱讀完整錯誤上下文

在編輯器開啟日誌,檢視最早的相關錯誤及前後文。分享前移除令牌、密碼及私人玩家資料,不要只憑最後一行判斷根因。

閱讀完整錯誤上下文
閱讀完整錯誤上下文2026-11-11 · 目前應用程式介面 · 示範資料 · 開啟原圖檢視

向支援說明請求

開啟支援工單,填寫服務或發票編號及具體請求。連線問題請附時間、錯誤和 MTR 證據,不要傳送密碼、令牌或銀行卡資料。

向支援說明請求
向支援說明請求2026-11-11 · 公開頁面 · 不含私人帳號資料 · 開啟原圖檢視

把報錯插件與實際檔案對應起來

先閱讀完整錯誤,找到插件名稱和版本,再進入 文件(檔案)→ plugins,核對 JAR 與目標版本及依賴要求。截圖是測試服範例,不代表每個插件都需要裝到自己的伺服器。

保留錯誤日誌並備份插件設定,停服後再替換或暫時移出可疑 JAR,每次只改一項,啟動後重現檢查。注意依賴關係,後續錯誤可能只是原始故障的結果。不要為消除錯誤就清空插件資料庫或重設全部設定。另見日誌和安裝插件。

插件錯誤範圍從小問題到導致伺服器崩潰的嚴重問題。本指南涵蓋常見插件問題及解決方案。

插件錯誤型別

啟動錯誤

插件在伺服器啟動時載入失敗:

  • 缺少依賴項(需要其他插件)
  • 錯誤的伺服器軟體版本(Bukkit vs Spigot vs Paper)
  • 不相容的 Minecraft 版本
  • 損壞的插件 JAR 檔案

執行時錯誤

插件載入後但在遊戲過程中丟擲錯誤:

  • NullPointerException(訪問不存在的物件)
  • 與其他插件衝突
  • 配置錯誤
  • 達到資料儲存限制

效能問題

插件消耗過多資源:

  • 高 CPU 使用率
  • 記憶體洩漏
  • 磁碟 I/O 過載

診斷步驟

檢查 控制檯 中的完整錯誤訊息。

識別導致錯誤的插件名稱。

檢查 logs/latest.log 中的時間線。

暫時禁用可疑插件以確認是哪個插件。

更新插件到最新版本。

如果問題持續,聯絡插件開發者。

常見修復

  • 缺少依賴項 — 安裝所需的庫插件(Vault、ProtocolLib 等)
  • 版本不匹配 — 使用與您的 Minecraft/伺服器軟體版本匹配的插件版本
  • 配置錯誤 — 將配置重置為預設值並重新配置

始終從 SpigotMC 或 PaperMC Hangar 等官方來源下載插件。修改過的或盜版的插件是崩潰和安全問題的常見來源。


Service information · Backups · Support

本頁內容