WTK 啟動錯誤「localhost has no IP address」根因與三大解決方案

錯誤現象

啟動 WTK (Wireless Toolkit) 模擬器時，KToolbar 主控台輸出：

WMAclient: localhost has no IP address: java.net.UnknownHostException: xxxxxx
Warning: Failed to initialize WMA message routing support
ClientConnector: localhost has no IP address: java.net.UnknownHostException: xxxxxx
Warning: Failed to initialize Bluetooth (JSR 82) support

或中文主機名版本：

WMAclient: localhost has no IP address: java.net.UnknownHostException: 梅花

根因分析

WTK 初始化 WMAClient 與 ClientConnector（藍牙 JSR 82）時，內部呼叫 InetAddress.getLocalHost() 解析本機主機名對應的 IP 位址。若解析失敗，拋出 UnknownHostException，導致 WMA（無線訊息API）與藍牙支援初始化失敗。

常見觸發場景

1. IP 位址變更：首次啟動 WTK 後，機器 IP 發生變更（DHCP 續約、切換網路），WTK 快取的主機名解析失效
2. 無網卡/網路介面：純離線開發環境，缺乏有效網路介面
3. 主機名含非 ASCII 字元：中文電腦名（如「梅花」）導致 JDK 网络層解析異常

三大解決方案

方案一：恢復首次啟動時的 IP 位址（最快）

• 固定靜態 IP 或預約 DHCP，確保 IP 不變
• 或修改 hosts 檔案強制綁定主機名至當前 IP

方案二：安裝/啟用網路介面

• 虛擬機環境：確認網路適配器已啟用（NAT/橋接模式）
• 實體機：檢查網卡驅動、啟用 Wi-Fi/乙太網路

方案三：將電腦名稱改為英文（根治中文主機名問題）

• Windows：控制台 → 系統 → 進階系統設定 → 電腦名稱 → 更改，僅使用字母、數字、連字號
• Linux：修改 /etc/hostname 及 /etc/hosts

技術原理深度解析

// JDK 文檔：InetAddress.getLocalHost()
public static InetAddress getLocalHost() throws UnknownHostException
// Throws: UnknownHostException - if no IP address for the host could be found.

WTK 依賴此標準 API 獲取本機 IP，作為本地 Socket 綁定、藍牙 SDP 服務註冊、WMA 推送註冊的基礎位址。解析失敗並非 WTK 本身缺陷，而是底層網路環境配置不完善。

預防性最佳實踐

• 開發機固定靜態 IP 或長租期 DHCP
• 電腦名稱純英文，避免編碼陷阱
• 啟動 WTK 前確認網路連通性（ping localhost 應解析至 127.0.0.1 或實體 IP）
• 防火牆/安全軟體加入 WTK/Java 例外規則，允許本地回環通訊