Java 對象轉 String 完全指南：三種方法差異、空值陷阱與最佳選型

三大核心方法對比

深度解析各方法行為

1. obj.toString()

Object obj = getObject();
System.out.println(obj.toString()); // obj 為 null → NPE

• 所有對象繼承自 Object，默認實現：getClass().getName() + "@" + Integer.toHexString(hashCode())
• 領域對象 必須覆寫 提供業務可讀表示
• 前置條件：obj != null

2. (String) obj — 強制轉型陷阱

Object obj = new Integer(100);
String s = (String) obj; // 編譯通過！運行拋 ClassCastException

Integer num = new Integer(100);
String s2 = (String) num; // 編譯錯誤：Integer 不兼容 String

• 編譯器僅檢查聲明類型 (Object 可轉任意引用類型)
• null 可轉為任意引用類型：(String) null 合法，結果為 null
• 最佳實踐：轉型前用 instanceof 檢查

3. String.valueOf(obj) — 源碼揭秘

public static String valueOf(Object obj) {
    return (obj == null) ? "null" : obj.toString();
}

• 空值安全：不拋 NPE，返回字面字符串 "null" (長度 4)
• 關鍵陷阱：String.valueOf(null) == "null" 為 true，但 String.valueOf(null) == null 為 false！
• 視覺誤導：System.out.println(String.valueOf(null)) 輸出 null，與 System.out.println(null) 視覺相同，但語義截然不同

常見錯誤模式與修正

錯誤 1：用 valueOf 結果判空

// 錯誤
if (String.valueOf(obj) == null) { ... } // 永不執行！valueOf 永不返回 null

// 正確
if (obj == null) { ... }
if (String.valueOf(obj).equals("null")) { ... } // 若真需檢查 "null" 字符串

錯誤 2：日誌記錄混淆 null 與 "null"

// 模糊
logger.info("Value: " + String.valueOf(value)); // value=null 記錄 "Value: null"

// 清晰
logger.info("Value: {}", value); // SLF4J 佔位符：null 顯示 "null"，但結構化日誌可區分
// 或
logger.info("Value: " + (value == null ? "NULL" : value.toString()));

錯誤 3：集合/映射鍵值轉換

Map map = ...
String key = (String) map.get("key"); // 危險！

// 安全
String key = String.valueOf(map.get("key")); // 返回 "null" 而非拋異常
// 或
Object raw = map.get("key");
String key = (raw instanceof String) ? (String) raw : null;

最佳實踐選型決策樹

1. 確知非空 + 需業務含義 → obj.toString() (領域對象已覆寫)
2. 可能為空 + 需安全字符串 → String.valueOf(obj) (日誌、調試、顯示)
3. 確知即為 String + 需保持 null 語義 → (String) obj (配合 instanceof 或非空斷言)
4. 集合/映射取值轉 String → String.valueOf(map.get(key)) 或模式匹配 (Java 16+)

現代 Java 增強 (Java 16+)

// 模式匹配 instanceof (Java 16+)
if (obj instanceof String s) {
    // s 為 String 類型，非空
    return s;
}
return String.valueOf(obj); // 其他情況安全轉換

// switch 表達式 (Java 14+)
String result = switch (obj) {
    case String s -> s;
    case null -> "NULL";
    default -> obj.toString();
};

總結

toString() 為領域對象業務表示；String.valueOf() 為通用安全轉換 (返回 "null" 字符串)；(String) 為類型斷言 (需配合檢查)。理解「null 引用」vs「\"null\" 字符串」的本質區別，是避免生產 Bug 的關鍵。日誌框架佔位符 ({}) 是現代最佳實踐，避免字符串拼接開銷與語義模糊。