Java 網路程式設計精通指南（6）：getCanonicalHostName() vs getHostName() — 主機名與別名區別

InetAddress 提供兩個獲取主機名的方法：getHostName() 返回**創建時使用的名稱**(可能是別名)；getCanonicalHostName() 返回**規範主機名**(真實 FQDN)。本文深入對比兩者在不同創建方式下的行為差異、DNS 交互機制及選擇指南。

方法簽名

public String getHostName()           // 返回主機別名或創建時的名稱
public String getCanonicalHostName()  // 返回規範主機名 (真實 FQDN)

三種創建場景下的行為對比

核心差異解析

1. 域名創建：別名 vs 規範名

許多網站使用 CNAME 別名 (如 www.oracle.com → bigip-otn-portal.oracle.com)：

• getHostName() 直接返回構造時傳入的字符串 (www.oracle.com)，**零 DNS 開銷**。
• getCanonicalHostName() 嘗試解析真實 FQDN，可能觸發 DNS 查詢 (視 JVM 緩存/OS 解析器行為)。

2. IP 創建：雙雙觸發反向 DNS

構造時不解析，首次調用任一方法才發起 PTR 查詢。若 DNS 不允許反解或 IP 無 PTR 記錄，雙雙返回 IP 字符串。

3. getLocalHost()：本機上下文

兩者均返回系統配置的主機名，無網路交互。

代碼演示與輸出

public class HostNameComparison {
    static void print(InetAddress addr, String label) {
        System.out.println("通過 " + label + " 創建:");
        System.out.println("  規範主機名: " + addr.getCanonicalHostName());
        System.out.println("  主機別名:   " + addr.getHostName());
        System.out.println();
    }
    public static void main(String[] args) throws Exception {
        print(InetAddress.getLocalHost(), "getLocalHost()");
        print(InetAddress.getByName("www.ibm.com"), "www.ibm.com");
        print(InetAddress.getByName("www.126.com"), "www.126.com");
        print(InetAddress.getByName("202.108.9.77"), "202.108.9.77 (126.com IP)");
        print(InetAddress.getByName("211.100.26.121"), "211.100.26.121 (csdn IP)");
    }
}

輸出結果

通過 getLocalHost() 創建:
  規範主機名: ComputerName
  主機別名:   ComputerName

通過 www.ibm.com 創建:
  規範主機名: www.ibm.com
  主機別名:   www.ibm.com

通過 www.126.com 創建:
  規範主機名: zz-9-77-a8.bta.net.cn
  主機別名:   www.126.com

通過 202.108.9.77 創建:
  規範主機名: zz-9-77-a8.bta.net.cn
  主機別名:   zz-9-77-a8.bta.net.cn

通過 211.100.26.121 創建:
  規範主機名: 211.100.26.121
  主機別名:   211.100.26.121

選擇指南

注意事項

• getCanonicalHostName() 可能拋出 SecurityException (安全管理器限制 DNS)。
• DNS 緩存 (JVM/OS) 影響首次調用延遲，後續調用極快。
• 某些 CDN/負載均衡器返回的 PTR 記錄可能為內部節點名而非公開域名。
• IPv6 地址反解同樣適用，返回 AAAA 記錄對應的 FQDN。