ClassCastException 是 RuntimeException 子类，运行时抛出，因强制转型类型不兼容（如 String 转 Integer）；应优先用 instanceof 校验或泛型预防，而非依赖 try-catch。
ClassCastException 是运行时异常，属于 RuntimeException 的子类，编译期不强制捕获，但一旦发生，说明类型转换逻辑存在缺陷。它通常出现在用 (TargetType) obj 强制转型时，而 obj 实际类型与目标类型不兼容（比如把 String 对象强转为 Integer）。
常见触发场景
以下代码会直接抛出 ClassCastException：
String s = "hello";
Integer i = (Integer) s; // 编译通过，运行时报错：java.lang.ClassCastException
其他典型情况包括：
• 从集合中取出 Object 后未校验类型就强转
• 使用反射获取对象后错误假设其具体类型
• 多态向下转型（如父类引用指向子类实例，但实际指向的是另一个子类）
立即学习“Java免费学习笔记（深入）”；
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
捕获 ClassCastException 的基本写法
虽然不是必须，但在明确知道某段转型可能失败、且有合理兜底逻辑时，应使用 try-catch 显式处理：
Object obj = getUnknownObject();
try {
String str = (String) obj;
System.out.println("成功转为字符串：" + str);
} catch (ClassCastException e) {
System.err.println("类型不匹配，无法转为 String：" + obj.getClass().getName());
// 可选：尝试其他转换方式，或返回默认值
String fallback = String.valueOf(obj);
}
更安全的替代方案（推荐优先使用）
比起“先转再捕获”，更好的做法是**预防性判断**，避免异常发生：
- 用
instanceof提前校验类型：
if (obj instanceof String) {
String s = (String) obj;
} - 对泛型集合，利用编译期类型检查，减少裸 Object 转型；
- 在 API 设计中，用方法重载或泛型方法替代模糊的 Object 参数；
- 必要时封装转型逻辑，统一处理失败情形，例如：
public static <T> T safeCast(Object obj, Class<T> targetType) {
if (targetType.isInstance(obj)) {
return targetType.cast(obj);
}
return null;
}
注意事项
• 不要空 catch ClassCastException 并忽略——这会掩盖真实逻辑错误；
• 日志中建议记录原始对象的 getClass().getName() 和 toString()，便于排查；
• 若频繁出现该异常，应反思设计：是否该用多态、策略模式或更严格的类型约束替代硬转型。
