萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

Tomcat 啟動報错 Cannot assign requested address: JVM_Bind 非埠口衝突排查實錄

異常堆疊

嚴重: StandardServer.await: create[8005]:
java.net.BindException: Cannot assign requested address: JVM_Bind
    at java.net.PlainSocketImpl.socketBind(Native Method)
    at java.net.PlainSocketImpl.bind(PlainSocketImpl.java:359)
    at java.net.ServerSocket.bind(ServerSocket.java:319)
    at org.apache.catalina.core.StandardServer.await(StandardServer.java:406)
    at org.apache.catalina.startup.Catalina.await(Catalina.java:676)
    ...

排查過程

  1. 排除埠口佔用:netstat -an 確認 8080/8005 無佔用,修改 server.xml 埠口仍失效
  2. 鎖定 IP 綁定問題:Tomcat 啟動時會解析 localhost 所有 IP 並逐個綁定
  3. 檢查 hosts 檔案:C:\Windows\System32\drivers\etc\hosts

根因

# 問題 hosts 內容
127.0.0.1       localhost
169.196.254.14  localhost  <-- 這個 IP 不存在於本機網卡

Tomcat 嘗試綁定 169.196.254.14 失敗,拋出 BindException。

解決方案

刪除 hosts 中錯誤的 IP 映射行,保留標準回環:

127.0.0.1       localhost
::1             localhost

重啟 Tomcat 即恢復正常。

驗證代碼

InetAddress[] ips = InetAddress.getAllByName("localhost");
if (ips != null) {
    for (InetAddress ip : ips) {
        System.out.println(ip.getHostAddress());
    }
}
// 修正前輸出:169.196.254.14, 127.0.0.1
// 修正後輸出:127.0.0.1

深度解析

  • 觸發條件:多網卡、VPN、虛擬網卡、Docker 等產生臨時 IP,若被寫入 hosts 映射 localhost
  • 影響範圍:所有依賴 InetAddress.getAllByName("localhost") 的 Java 應用
  • 預防:勿手動修改 hosts 映射 localhost 至非回環地址;使用 127.0.0.1 明確綁定

server.xml 顯式綁定建議

<Server port="8005" shutdown="SHUTDOWN" address="127.0.0.1">
<Connector port="8080" protocol="HTTP/1.1" address="127.0.0.1" />

明確指定 address="127.0.0.1" 避免綁定異常 IP。

copyright © 萬盛學電腦網 all rights reserved