架构与系统设计 / 系统课时
渐进重构高耦合业务模块
渐进重构高耦合业务模块
高耦合模块最危险的改法不是“改得慢”,而是一次性重写后失去行为参照。本课用可回退的渐进路径拆职责、倒置依赖,并通过适配器保留旧实现,让每一步都能独立验证。
学习目标
- 能先建立行为基线,再拆分高耦合职责
- 能用依赖倒置和适配器逐步替换具体依赖
- 能把重构拆成可验证、可回退的小批次变更
先锁定行为边界
重构前先明确哪些行为不能变,例如订单金额、支付调用次数、通知触发条件、异常返回方式。不要一边改结构一边顺手修改业务规则,否则失败时很难判断是结构调整还是需求变化造成的。
基线可以来自现有自动化测试,也可以先补一组针对公开入口的特征测试。测试不需要覆盖内部实现细节,重点是固定调用输入、外部可见输出和关键副作用。
找到最小可切割缝隙
高耦合业务通常不是“所有代码都一样糟”,而是某个核心类同时直接创建支付客户端、发送通知、访问存储并拼接业务规则。第一步不要拆成十几个类,而是优先切开变化最频繁、最难替换的外部依赖。
常见顺序是先把具体客户端藏到接口后面,再让核心业务依赖接口。此时业务流程仍然保持原样,只是调用方向从“业务类依赖具体实现”变为“业务类依赖抽象”。
分阶段引入依赖倒置
渐进重构的关键是每次只改变一个结构事实,并在通过验证后再进入下一阶段。

推荐的提交粒度是:先补基线测试;再只提取接口;随后增加旧客户端适配器;接着把一个调用入口切到新依赖;最后才删除旧路径。这样任何一步出错,都能回到前一个可运行版本。
用适配器保留旧系统可用
下面的示例没有重写旧支付和短信客户端,而是用两个适配器把它们接到新接口上。核心业务只依赖抽象,因此未来可以替换实现,而旧系统仍然继续工作。
public class GradualRefactorDemo {
interface PaymentGateway {
String pay(int amount);
}
interface Notifier {
void send(String orderId);
}
static final class LegacyPaymentClient {
String charge(int amount) {
return "PAY_OK:" + amount;
}
}
static final class LegacySmsClient {
void sendSms(String text) {
System.out.println("SMS:" + text);
}
}
static final class PaymentAdapter implements PaymentGateway {
private final LegacyPaymentClient client;
PaymentAdapter(LegacyPaymentClient client) {
this.client = client;
}
public String pay(int amount) {
return client.charge(amount);
}
}
static final class SmsNotifierAdapter implements Notifier {
private final LegacySmsClient client;
SmsNotifierAdapter(LegacySmsClient client) {
this.client = client;
}
public void send(String orderId) {
client.sendSms(orderId);
}
}
static final class OrderService {
private final PaymentGateway payment;
private final Notifier notifier;
OrderService(PaymentGateway payment, Notifier notifier) {
this.payment = payment;
this.notifier = notifier;
}
String checkout(String orderId, int amount) {
String result = payment.pay(amount);
notifier.send(orderId);
return result + ",ORDER:" + orderId;
}
}
public static void main(String[] args) {
OrderService service = new OrderService(
new PaymentAdapter(new LegacyPaymentClient()),
new SmsNotifierAdapter(new LegacySmsClient())
);
System.out.println(service.checkout("order-42", 199));
}
}预期输出
SMS:order-42
PAY_OK:199,ORDER:order-42这个阶段的价值不是“已经完成架构升级”,而是建立了替换缝隙。接下来可以只替换 PaymentGateway 的实现,而不同时改通知逻辑和订单流程,回归范围明显缩小。
验证并删除旧路径
每切换一批调用,都要重新执行行为基线,并检查关键副作用次数是否变化。例如支付不能因为重试逻辑迁移而重复扣款,通知也不能在新旧路径同时存在时发送两次。
只有当新路径覆盖全部生产调用、监控稳定且回滚窗口结束后,才删除旧构造方式和无用适配层。渐进重构的完成标准不是“类图更漂亮”,而是行为保持、依赖边界更清楚,并且后续变化能够在更小范围内完成。