Java 反射繞過泛型檢查導致 ClassCastException 深度解析

現象重現

代碼創建 HashMap<Integer, String>，通過反射獲取 put(Object, Object) 方法並調用 put(map, 1, new Object())。編譯運行均無錯，但調用 map.get(1) 時拋出 ClassCastException: java.lang.Object cannot be cast to java.lang.String。

根本原因：類型擦除

Java 泛型採用類型擦除機制：編譯期進行類型檢查，生成的字節碼中不保留泛型參數信息。運行時 HashMap<Integer, String> 實際只是原始 HashMap，鍵值類型均為 Object。反射調用 Method.invoke 繞過了編譯器檢查，直接向 Map 放入 Object 實例，導致後續取值時強制轉型失敗。

關鍵知識點

• 擦除後簽名：Map.put(K, V) 擦除為 put(Object, Object)，反射獲取的正是此方法。
• 橋接方法：編譯器會生成橋接方法實現多態，但反射直接調用原始方法。
• 運行時類型安全：Java 泛型僅提供編譯期保證，運行時需自行防範堆污染。

最佳實踐

1. 避免在性能敏感代碼中對泛型集合使用反射操作。
2. 若必須反射操作，運行前顯式檢查類型：if (value instanceof String)。
3. 考慮使用 Class<T> 傳遞類型標記，或採用 Gson/Jackson 等庫處理序列化。

延伸閱讀

參考《深入理解 Java 虛擬機》第 10 章「類型擦除與泛型實現原理」，及 Java 泛型實現原理：類型擦除。