保持java接口向后兼容的核心是“老代码不改也能跑”，即只增不删、慎动签名、废弃用@deprecated保留原定义；新增方法优先用default方法，新增字段限public static final常量；模块化需exports契约包，多版本jar可分场景保留语义；版本过渡须设兼容期、告警机制与明确下线规则。
保持 Java 接口向后兼容的演进，核心是“老代码不改也能跑”。不是不让改，而是改得有章法、有约束、有兜底。
只增不删，字段和方法都慎动
一旦接口发布，所有 public 方法、public static final 常量、以及它们的签名（名称、参数类型、返回类型、异常声明）就构成了调用方依赖的契约。删除、重命名、改类型、收紧参数校验，都会直接导致编译失败或运行时异常。
- 新增方法：优先用 default 方法，实现类无需修改即可使用
- 新增字段：仅限 public static final 常量；避免新增非 final 字段（接口本不该有实例状态）
- 废弃旧项：用 @Deprecated 注解 + Javadoc 说明替代方案，但保留原定义
默认方法是安全扩展的主力工具
Java 8 引入 default 方法，就是为了解决“想加功能，又不能逼所有人改代码”的困境。它让接口在二进制层面保持兼容——老实现类加载时不报错，调用时按需继承或重写。
Java Development Manual
下载
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 新增行为尽量封装为 default 方法，而非抽象方法
- 多个接口提供同名 default 方法时，实现类必须显式重写，这是明确冲突点，不是缺陷
- 需要复用某一方逻辑时，可用 InterfaceName.super.method() 显式调用
模块化下更要守住导出与签名稳定性
Java 9+ 模块化本身不保证兼容，但它放大了兼容性风险：一个未导出的包，会让原本可访问的常量或工具类瞬间“消失”；一个被移除的 public static final 字段，即使还在 class 文件里，也可能因模块封装而不可见。
- module-info.java 中必须 exports 所有含公共契约的包（如含常量、DTO、接口的包）
- 旧变量所在类不能降级为 package-private 或移入私有嵌套类
- 若语义需分版本（如超时值变更），用多版本 JAR（Multi-Release JAR）按 JDK 版本加载不同 class
版本过渡要有明确规则和退出机制
兼容不是永久背负历史包袱。团队需约定清晰的生命周期策略，让各方对“何时能删”心里有数。
- 新接口上线时同步公布兼容期（例如：v1 接口自 v2 发布起保留 12 个月）
- 过期前通过日志、监控、HTTP Header 等方式主动告警调用方
- 删除前确保所有内部系统和主要外部合作方已完成迁移
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
