Java接口通过default方法实现平滑升级，需满足三硬条件：编译目标≥JDK8、运行时JDK≥编译版本、实现类无同签名方法；多接口冲突须显式@Override解决；升级分兼容期、提示期、清理期三阶段推进。
Java 接口通过 default 方法实现平滑升级，核心不是“加个方法就行”，而是让新功能自动落到旧实现类上，同时不破坏编译和运行——前提是设计有节奏、调用有约束、升级有阶段。
默认方法只解决行为追加，不改变契约
它适用于在已有接口上补充能力，而不是修改原有方法签名。比如原接口只有 void log(String msg)，现在想支持带标签的日志，可以新增：
-
✅ 允许：添加
default void logWithTag(String tag, String msg) { log("[" + tag + "] " + msg); }，复用已有抽象方法 -
❌ 禁止：把
String process(String)改成String process(String, boolean)；必须另起名，如processWithFlag() -
⚠️ 风险：default 方法里调用
this.getCache()，但实现类没这个方法 → 运行时报NoSuchMethodError
确保 default 方法真正生效的三个硬条件
缺一不可，否则旧实现类根本用不上新方法：
- 接口编译目标版本 ≥ JDK 8（Maven 中
<source>1.8</source>且<target>1.8</target>） - 所有调用方运行时 JDK 版本 ≥ 接口编译版本（JDK 7 运行会失败）
- 实现类字节码中没有同签名方法（哪怕只是空实现
public void close() {}，default 就被忽略）
验证方式：javap -v YourImpl.class 查看方法表，若无新增方法名，说明走的就是接口 default 回退逻辑。
立即学习“Java免费学习笔记（深入）”；
多接口冲突必须显式解决
当一个类实现多个含同签名 default 方法的接口，编译器不会静默选一个，而是报错：
class inherits unrelated defaults for close() from types InterfaceA and InterfaceB唯一合法解法是在实现类中：
- 加上
@Override - 明确写清调用路径，例如：
InterfaceA.super.close();
不能漏掉 @Override，也不能只写 InterfaceA.super.close(); 而不覆盖该方法。
分阶段推进升级节奏
平滑不是一次发布完成，而是可控演进：
-
兼容期：添加 default 方法，逻辑尽量基于已有抽象方法组合（如
findActiveUsers()基于findAll()过滤） -
提示期：在旧方法 Javadoc 标注
@deprecated，并在 default 方法体中加入开发环境日志提醒迁移（如if (isDev()) System.err.println("请迁移到 findActiveUsers()")） - 清理期：待多数实现类完成覆盖后，在下一个主版本（如 v2.0 或 2026 年底）移除旧抽象方法
