1. 简介
在我们编译 Java 源文件的时候，有时会看到编译器输出类似 unchecked cast 的警告信息。
这篇文章我们就来深入探讨这个警告到底意味着什么，为什么 Java 要给我们发出警告，以及我们应该如何正确处理它。
有些 Java 编译器默认是关闭这类警告的。✅
在继续之前，请确保你已经启用了编译器的 unchecked 警告选项。
2. unchecked cast 警告到底是什么意思？
✅ unchecked cast 是一个编译时警告。
简单来说，当你将一个原始类型（raw type）强制转换为泛型类型（parameterized type）时，编译器无法进行类型检查，就会抛出这个警告。
举个例子：
public class UncheckedCast {
public static Map getRawMap() {
Map rawMap = new HashMap();
rawMap.put("date 1", LocalDate.of(2021, Month.FEBRUARY, 10));
rawMap.put("date 2", LocalDate.of(1992, Month.AUGUST, 8));
rawMap.put("date 3", LocalDate.of(1976, Month.NOVEMBER, 18));
return rawMap;
}
...
}
然后我们写一个测试方法，将这个原始类型 Map 强转为 Map<String, LocalDate>：
@Test
public void givenRawMap_whenCastToTypedMap_shouldHaveCompilerWarning() {
Map<String, LocalDate> castFromRawMap = (Map<String, LocalDate>) UncheckedCast.getRawMap();
Assert.assertEquals(3, castFromRawMap.size());
Assert.assertEquals(castFromRawMap.get("date 2"), LocalDate.of(1992, Month.AUGUST, 8));
}
✅ 编译器允许这种转换，是为了向后兼容不支持泛型的老版本 Java。
但如果你真的去编译这段代码，就会看到警告：
$ mvn clean test
...
[WARNING] .../src/test/java/com/baeldung/uncheckedcast/UncheckedCastUnitTest.java:[14,97] unchecked cast
required: java.util.Map<java.lang.String,java.time.LocalDate>
found: java.util.Map
...
虽然测试能跑通，但这个警告不是白给的，背后潜藏风险。
3. 为什么编译器要警告我们？
我们刚才的例子中，测试是能跑通的，因为原始 Map 里确实都是 <String, LocalDate> 类型的键值对。
但如果原始 Map 里混入了其他类型的值呢？比如：
public static Map getRawMapWithMixedTypes() {
Map rawMap = new HashMap();
rawMap.put("date 1", LocalDate.of(2021, Month.FEBRUARY, 10));
rawMap.put("date 2", LocalDate.of(1992, Month.AUGUST, 8));
rawMap.put("date 3", LocalDate.of(1976, Month.NOVEMBER, 18));
rawMap.put("date 4", new Date());
return rawMap;
}
然后我们再写一个测试：
@Test(expected = ClassCastException.class)
public void givenMixTypedRawMap_whenCastToTypedMap_shouldThrowClassCastException() {
Map<String, LocalDate> castFromRawMap = (Map<String, LocalDate>) UncheckedCast.getRawMapWithMixedTypes();
Assert.assertEquals(4, castFromRawMap.size());
Assert.assertTrue(castFromRawMap.get("date 4").isAfter(castFromRawMap.get("date 3")));
}
虽然编译时只有警告，但运行时却会抛出 ClassCastException —— ❌ 而且是在你真正使用错误类型的数据时才抛出。
⚠️ 这就非常坑了，因为错误被延迟暴露，可能导致大量错误数据已经进入流程。
4. 如何处理 unchecked cast 警告？
4.1. 避免使用原始类型
✅ 自 Java 5 开始支持泛型后，我们就应该尽量避免使用原始类型（raw type）。
原始类型会让我们失去泛型带来的类型安全和表达力。
对于遗留代码，我们应该逐步重构，使用泛型代替原始类型。
4.2. 使用 @SuppressWarnings("unchecked") 压制警告
⚠️ 如果你确定转换是类型安全的，但又无法避免原始类型（比如调用第三方库），那可以使用注解压制警告：
@SuppressWarnings("unchecked")
Map<String, LocalDate> castFromRawMap = (Map<String, LocalDate>) UncheckedCast.getRawMap();
⚠️ 注意： 建议只在最小作用域上使用该注解，避免掩盖其他潜在问题。
比如 ArrayList 源码中的写法：
@SuppressWarnings("unchecked") E oldValue = (E) es[index];
4.3. 在使用前进行类型检查
✅ 如果你不确定转换是否安全，最好在使用前手动做类型检查，这样可以尽早发现 ClassCastException。
Object rawMap = UncheckedCast.getRawMapWithMixedTypes();
if (rawMap instanceof Map) {
Map<?, ?> map = (Map<?, ?>) rawMap;
for (Map.Entry<?, ?> entry : map.entrySet()) {
if (!(entry.getKey() instanceof String)) {
throw new ClassCastException("Key is not a String");
}
if (!(entry.getValue() instanceof LocalDate)) {
throw new ClassCastException("Value is not a LocalDate");
}
}
// 安全转换
Map<String, LocalDate> safeMap = (Map<String, LocalDate>) rawMap;
}
这样虽然代码多了点，但能提前暴露问题，避免运行时爆炸。
5. 总结
在这篇文章中，我们讨论了 Java 编译器发出的 unchecked cast 警告的意义，以及它背后可能隐藏的运行时风险。
我们还介绍了几种处理方式：
- ✅ 避免使用原始类型
- ⚠️ 合理使用
@SuppressWarnings("unchecked") - ✅ 在转换前做类型检查，尽早发现问题
最后，示例代码可以在 GitHub 上找到。