Java InetAddress 核心指南：IP 地址解析與特殊地址判斷詳解

前言

java.net.InetAddress 是 Java 網絡編程中處理 IP 地址與主機名的核心類。它封裝了數字 IP 地址及其對應的域名，提供了靜態工廠方法創建實例，並內建 10 種判斷特殊 IP 地址類型的方法。本文將系統講解其核心 API、工廠方法、特殊地址分類判斷邏輯，並提供完整可運行的檢測工具代碼。

一、InetAddress 核心特性

• 不可實例化：無公共構造器，必須通過靜態工廠方法獲取實例。
• 內部封裝：隱藏了底層數字地址細節，提供高級 API。
• 域名解析：自動處理主機名與 IP 的雙向解析 (依賴 DNS)。
• IPv4/IPv6 雙棧支持：統一 API 處理兩種協議地址。

二、三大工廠方法詳解

1. getLocalHost() - 獲取本機地址

InetAddress localhost = InetAddress.getLocalHost();
// 輸出示例: hostname/192.168.1.100 (IPv4) 或 hostname/[fe80::...] (IPv6)
// 等價於 localhost (127.0.0.1 / ::1) 但返回真實網卡 IP

注意：多網卡環境下返回第一張非回環網卡 IP，容器化環境可能返回內網 IP。

2. getByName(String host) - 單地址解析

InetAddress sohu = InetAddress.getByName("www.sohu.com");
// 輸出: www.sohu.com/220.181.38.148
// 若域名對應多個 IP，返回第一個
// 解析失敗拋出 UnknownHostException

3. getAllByName(String host) - 多地址解析

InetAddress[] addresses = InetAddress.getAllByName("www.google.com");
// 返回所有解析到的 IP 地址數組 (包含 IPv4/IPv6)
// 至少解析到一個地址才會返回，否則拋出 UnknownHostException

三、十大特殊 IP 地址判斷方法全景圖

以下方法均為實例方法，返回 boolean。IPv4/IPv6 判斷邏輯不同，下表總結核心範圍：

四、實戰：通用特殊地址檢測工具

利用反射動態調用所有 isXxx() 方法，無需硬編碼即可適配未來 JDK 新增判斷方法：

import java.lang.reflect.Method;
import java.net.InetAddress;
import java.net.UnknownHostException;

public class IPTypeDetector {
    public static void main(String[] args) {
        if (args.length == 0) {
            System.err.println("用法: java IPTypeDetector ");
            System.err.println("示例: java IPTypeDetector 224.0.0.1");
            System.err.println("示例: java IPTypeDetector FF02::1");
            System.err.println("示例: java IPTypeDetector www.google.com");
            return;
        }

        try {
            InetAddress address = InetAddress.getByName(args[0]);
            System.out.printf("檢測目標: %s (%s)%n", address.getHostAddress(), address.getCanonicalHostName());
            System.out.println("----------------------------------------");

            Method[] methods = InetAddress.class.getDeclaredMethods();
            for (Method method : methods) {
                String name = method.getName();
                // 匹配以 "is" 開頭、無參數、返回 boolean 的方法
                if (name.matches("is[A-Z].*") && method.getParameterCount() == 0 && method.getReturnType() == boolean.class) {
                    try {
                        boolean result = (boolean) method.invoke(address);
                        if (result) {
                            System.out.printf("✅ %-20s = true%n", name);
                        }
                    } catch (Exception e) {
                        // 忽略調用異常 (如安全限制)
                    }
                }
            }
        } catch (UnknownHostException e) {
            System.err.println("❌ 無法解析主機: " + e.getMessage());
        }
    }
}

運行示例

$ java IPTypeDetector 224.0.0.1
檢測目標: 224.0.0.1 (224.0.0.1)
----------------------------------------
✅ isMulticastAddress    = true
✅ isMCLinkLocal         = true

$ java IPTypeDetector FF02::1
檢測目標: ff02::1 (ff02::1)
----------------------------------------
✅ isMulticastAddress    = true
✅ isMCLinkLocal         = true

$ java IPTypeDetector 192.168.1.100
檢測目標: 192.168.1.100 (192.168.1.100)
----------------------------------------
✅ isSiteLocalAddress    = true

五、最佳實踐與避坑指南

1. 優先使用 getAllByName()：生產環境解析域名時獲取所有 IP，實現客戶端負載均衡或故障轉移。
2. 緩存解析結果：JDK 默認緩存 TTL 為永久 (networkaddress.cache.ttl=-1)，動態 DNS 環境需調整為合理值 (如 60 秒) 或定期手動刷新。
3. IPv6 兼容性測試：雙棧環境下測試所有網絡代碼，注意 isSiteLocalAddress() 在 IPv6 中語義已變 (ULA)，新代碼建議檢測 fc00::/7 (ULA) 替代。
4. 異常處理：所有網絡調用必須捕獲 UnknownHostException、SocketException，避免單點故障拖垮主線程。
5. 安全敏感場景：不要單純依賴 IP 判斷信任關係 (易偽造)，需結合 TLS、Token、mTLS 等強認證機制。

六、總結

InetAddress 是 Java 網絡層的基石，掌握其工廠方法創建實例、理解十大特殊地址判斷邏輯、善用反射編寫通用檢測工具，能顯著提升網絡編程的健壯性與可維護性。結合現代框架 (Netty, Spring Cloud) 的內建解析機制，通常無需直接操作底層 API，但原理掌握是排查疑難雜癥的關鍵。