java类名冲突本质是全限定名重复或加载错配，解决关键在于包隔离、显式引用和类加载器控制：不同包下同名类（如com.example.user.user与com.example.api.user）天然独立；import仅为语法糖，需严格匹配目录结构；同名类共存时须用全限定名或java 10+的import as别名；多版本共存依赖自定义classloader隔离。
Java 类名冲突不是“名字撞了”那么简单，而是全限定名（包名+类名）在类加载阶段被重复或错配导致的运行时问题。解决的关键不在改类名，而在控制“谁先被加载”和“由谁来加载”。
用包机制隔离同名类
包本质是命名空间，让 com.example.user.User 和 com.example.api.User 成为两个完全不同的类型。只要包路径严格匹配文件系统目录（如 src/main/java/com/example/user/User.java），JVM 就能区分它们。import 只是语法糖，真正起作用的是编译后生成的全限定名。
- 确保每个同名类放在不同包下，且 package 声明与物理路径一致
- 避免手动移动 .java 文件却不更新 package 声明，否则会报 “class file contains wrong class”
- 包名推荐用反向域名（如
org.mycompany.service），降低全局重名概率
引用冲突类时明确指定来源
当必须在同一个类里使用多个同名类时，不能只靠 import，得靠“显式路径”或“别名”。
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 直接写全限定名：比如
new com.example.admin.User()和new com.example.dto.User() - Java 10+ 支持 import as 别名：
import com.example.admin.User as AdminUser;，之后用AdminUser实例化 - 低版本 Java 或仅少量使用场景，优先用全限定名——兼容性强，无额外依赖
控制类加载顺序，避免“先到先得”踩坑
JVM 加载类是按 classpath 中 jar 的排列顺序“先到先得”，一旦某个类被 ApplicationClassLoader 加载，后续同名类就被忽略。冲突常发生在多版本 jar 共存时。
- 在 IDE 中检查依赖顺序：IntelliJ 是 Project Structure → Modules → Dependencies；Eclipse 是 Properties → Java Build Path → Order and Export
- 运行时加
-verbose:class查看实际加载了哪个 jar 里的类 - Maven 构建时用
<exclusions></exclusions>排除传递依赖中的冲突版本，或用maven-enforcer-plugin锁定版本
需要多版本共存时，用自定义类加载器隔离
当项目必须同时用旧版 POI 和新版 POI（比如老模块依赖 3.x，新功能要用 5.x 的公式函数），靠改包名或排除依赖都不够，就得靠类加载器隔离。
- 把新版库打成独立 jar（可用 maven-shade-plugin 重定位内部包，避免内部类冲突）
- 编写 URLClassLoader，从指定路径加载该 jar，确保它和主应用的 ClassLoader 不共享命名空间
- 通过反射或接口约定调用目标方法，避免直接强依赖新版类
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
