無法連線 Minecraft Java 伺服器？完整排錯指南

「連不上」包含多種故障。連線遭拒、逾時、找不到主機、版本過舊、認證失敗和模組握手錯誤不應套用同一種解法。先保存原始訊息，再由伺服器向外排查；一開始就關閉所有防火牆或重裝遊戲只會增加風險。

記下完整錯誤與影響範圍

保存客戶端原文、發生時間、地址與連接埠、Java 版本、啟動器設定、載入器和模組包。確認是所有玩家失敗，還是只有一人；服主能否在本機連線，面板是否真的完成啟動。保留同一時間的伺服器日誌。

公開求助時不要貼面板密碼、API 金鑰、私網細節或含憑據的完整日誌。錯誤與時間要保留，敏感欄位則應遮蔽。

從程序啟動第一行讀到正常就緒。面板顯示綠色不代表 Java 已完成啟動；缺少模組、連接埠占用、EULA、世界損壞或記憶體不足都可能讓程序先退出。若程序崩潰，先處理第一個啟動錯誤。

程序在線時核對監聽連接埠和 server-ip。Paper 通常建議沒有特殊網路需求時留空 server-ip。不要連續按重啟，否則只會得到多份被截斷的日誌。

標準 Java 伺服器需要 Java 客戶端；基岩版不能只靠同一 IP 直接加入。確認玩家開啟 Minecraft: Java Edition。用戶端與伺服器協定版本需相容，「用戶端過舊」或「伺服器過舊」屬於版本問題。

模組服還需匹配載入器、模組包版本和必要模組。與一名能正常加入的玩家比較完整設定，比隨機逐一加檔案更有效。診斷時優先使用穩定版，Snapshot 和協定轉接外掛會增加變數。

由主機目前的連線頁複製地址，移除 https://、網頁路徑與空白。非預設連接埠要寫成 example.net:25570。找不到主機多半指向拼字或 DNS；連線遭拒常見於未監聽、連接埠錯誤或規則拒絕；逾時則可能是路徑中封包被丟棄。

192.168.x.x 等私人地址通常只在區域網路可用。自架服要開放公網，必須明確設定路由與防火牆，也要理解暴露服務的安全風險。

所有人都失敗：先查啟動、地址、連接埠、主機狀態與綁定。區網可進但公網不可：檢查連接埠轉送、公網 IP、電信業者 CGNAT、防火牆或主機配置。大多數人可進、只有一人失敗：查該玩家版本、帳號、DNS、本機網路、安全軟體與模組包。

若玩家已到達伺服器卻被踢出，日誌通常會留下認證、白名單、封鎖、重複登入或模組握手原因。相同時間完全沒有紀錄，代表請求可能未到達這個 Java 程序。

確認玩家登入正確的 Microsoft 帳號，家庭或隱私設定允許多人遊戲。工作階段過期可正常登出再登入，但任何人都不應索取驗證碼或密碼。白名單需核對目前 Java 使用者名稱，也要檢查封鎖與官方認證服務狀態。

若很多玩家突然同時認證失敗，先確認官方服務狀態，不要為短期事故永久關閉正版驗證。

確認程序和連接埠後，再檢查作業系統防火牆、路由器或主機安全群組。只允許 Java 程序或指定 TCP 埠與正確網路設定，不要永久關閉防火牆、防毒、路由保護或身分驗證。

家用網路需將外部連接埠轉送到目前伺服器內網地址；CGNAT 下普通轉送可能無效，應詢問電信業者或使用可信主機，而不是不斷放寬規則。手機熱點可作為比較測試，不應成為永久旁路。

仍未解決時，整理用戶端錯誤、時間與時區、受影響玩家、本機與公網結果、伺服器版本與核心、地址類型、完整啟動片段及失敗連線日誌。主機商才能直接查看配置與路由。

有效順序是：錯誤原文、完整啟動、Java 與版本、地址連接埠、影響範圍、帳號拒絕，最後才是窄範圍網路規則。這樣既能縮短停機，也不會把普通連線問題變成資安漏洞。