Java模块化系统（JPMS）下类型转换失败主因是同一类被不同模块重复加载导致类型不兼容，解决需确保Model模块唯一、显式声明依赖、避免类路径混入、使用模式匹配及接口抽象。
Java模块化系统（JPMS）改变了类型可见性与加载规则，直接冲击传统类型转换逻辑。核心问题不是“怎么转”，而是“能不能转”——当同一个类被不同模块路径下的类加载器重复加载，它们在JVM中就是两个不兼容的类型，强制转换必然失败。
确保类型唯一性：模块依赖必须显式且唯一
类型转换失败最常见的原因是Foo类被加载了两次：一次来自主应用模块路径，一次来自动态加载的Implementation模块所携带的Model副本。解决的关键是让所有模块共享同一个Model实例。
- 主应用必须声明
requires Model;，且Model必须作为独立模块放在模块路径上，不能混入类路径或打包进其他jar - 动态加载Implementation模块时，
ModuleFinder不能包含Model的jar；应优先使用ModuleFinder.ofSystem()或明确排除Model相关路径 - 构建时用
--module-path而非-cp启动，确保JVM以模块模式运行，未命名模块不会偷偷劫持Model类
用模式匹配替代强制转换：安全又简洁
即使类型可见，传统if (obj instanceof Foo) { Foo f = (Foo) obj; ... }仍存在冗余和潜在风险。Java 16+的instanceof模式匹配可一步到位，且编译器保障类型安全。
- 写法变为
if (obj instanceof Foo f) { return f.getName(); }，变量f在作用域内自动具备Foo类型，无需二次断言 - 该语法仅在目标类型对当前模块可见时才允许——即Foo必须已被导出且被当前模块requires，天然契合模块边界约束
- 结合sealed class使用时，编译器还能检查是否覆盖全部子类型，进一步杜绝漏判
跨模块交互优先走接口，避免具体类型传递
模块化设计哲学是“依赖抽象，而非实现”。若Implementation模块返回Foo实例，而Foo是具体类，就容易陷入加载器隔离陷阱；若Foo是接口，则可通过服务机制解耦。
立即学习“Java免费学习笔记（深入）”；
- 将Foo定义为接口，放在独立API模块中，由Model和Implementation共同requires
- Implementation模块用
provides Foo with ConcreteFooImpl;声明实现 - 主应用通过
ServiceLoader.load(Foo.class)获取实例，拿到的就是接口类型，完全规避转换问题 - 如需扩展行为，可配合record封装数据、sealed class限定分支，再用switch模式匹配统一处理
调试与验证：确认类型归属是第一步
遇到ClassCastException时，不要急着改代码，先确认JVM中实际加载的是哪个类。
- 打印对象的类加载器：
obj.getClass().getClassLoader()，对比期望模块的类加载器是否一致 - 检查模块图：
java --module-path ... --list-modules，确认Model是否只出现一次 - 运行时查看模块导出：
java --module-path ... -m app/com.example.Main --describe-module Model，验证exports是否生效 - 启用模块调试：
-XX:+TraceClassLoading -XX:+TraceClassUnloading，观察Foo类是否被多次定义
