微服务设计：解密防腐层（Anticorruption Layer, ACL）在旧系统集成中的设计与落地规范

在企业级微服务重构和架构演进的过程中，新系统几乎不可能在一夜之间完全替代旧的遗留系统（Legacy System）。新旧系统必须在相当长的一段时间内并存并进行频繁的同步数据交互。

然而，遗留系统往往存在数据库表结构混乱、业务概念畸形、接口协议奇特等“坏味道”。如果让新系统的微服务直接去调用旧系统的接口，新系统的领域模型就会被遗留系统的畸形概念严重污染，导致重构后的微服务迅速退化为不可维护的混乱系统。

为了在新旧系统集成时筑起一道安全的隔离大坝，**领域驱动设计（DDD）** 提出了核心战术集成模式——**防腐层（Anticorruption Layer, ACL）**。

本文将系统拆解防腐层的核心分层定位、内部翻译机制以及具体的代码架构落地规范。

一、 什么是防腐层（ACL）及其物理定位

防腐层是介于新旧系统（或两个相异限界上下文）之间的一个**转换与隔离适配层**。它在逻辑上属于新系统限界上下文的一部分，位于分层架构的**基础设施层（Infrastructure Layer）**：

      [ 新系统领域层 (Domain Layer) ]
                     │
                     ▼ 1. 发起纯净的领域服务调用 (MyService)
      [ 新系统基础设施层 (ACL 防腐层) ]
                     │
       ┌─────────────┴─────────────┐
       ▼                           ▼
[ 适配器 (Adapter) ]       [ 翻译器 (Translator) ] (执行数据结构与语义的翻译)
       │                           │
       └─────────────┬─────────────┘
                     │
                     ▼ 2. 发起经过包装的 RPC/HTTP 请求
          [ 外部遗留系统 (Legacy System) ]

如上图所示，新系统领域层只面对防腐层暴露的干净、优雅的内部接口。所有的复杂转换、历史历史包袱、报文协议兼容全部被封锁在防腐层内部消化，确保新系统核心不受外部任何影响。

二、 防腐层（ACL）的核心组成与设计红线

一个标准的防腐层由**适配器（Adapter）**与**翻译器（Translator）**两部分协作构成，且在设计上必须坚守三条红线约束：

1. 适配器（Adapter）的职责

适配器负责处理网络技术细节和协议转换。它负责将新系统的本地接口调用转化为调用旧系统所需的具体网络协议（如 SOAP Webservice、旧版的 HTTP/JSON 甚至直接执行原生 SQL 读写）。

2. 翻译器（Translator）的职责

翻译器是一个纯粹的**双向数据翻译槽**。它负责将旧系统返回的奇特响应（如 XML 报文或包含混乱缩写的 DTO）翻译为新系统领域层能看懂的**值对象（Value Object）或实体（Entity）**。

3. 设计红线：严禁让旧系统的概念穿透防腐层

外部遗留系统的任何字段、DTO、名词定义**绝对不允许出现在新系统的领域层和应用层代码中**。所有的概念必须在防腐层内部被 100% 翻译过滤。

三、 代码实战：在基础设施层落地防腐集成

以下是一个严格符合 DDD 分层规范的“客户系统防腐集成”代码结构实现：

1. 领域层：声明纯净接口与值对象（Domain Layer）

package com.company.domain.model;

/**
 * 新系统的统一客户值对象：仅包含清晰、合规的业务定义
 */
public final class Customer {
    private final String customerId;
    private final String vipLevel;

    public Customer(String customerId, String vipLevel) {
        this.customerId = customerId;
        this.vipLevel = vipLevel;
    }
    
    public String getCustomerId() { return customerId; }
    public String getVipLevel() { return vipLevel; }
}

2. 基础设施层：防腐层适配器与翻译器实现（Infrastructure Layer）

package com.company.infra.acl;

import com.company.domain.model.Customer;
import com.company.infra.legacy.LegacyClient; // 旧系统客户端

/**
 * 客户防腐层实现：实现新系统的内部接口，内部隔离旧系统客户端
 */
@Component
public class CustomerAclService {

    @Autowired
    private LegacyClient legacyClient; // 注入旧系统客户端

    public Customer getCustomerInfo(String customerId) {
        // 1. 调用旧系统客户端，获取旧系统返回的混乱 DTO
        LegacyUserDTO legacyUser = legacyClient.fetchUserById(customerId);
        
        // 2. 调用翻译器，在隔离带内完成转换，阻断污染
        return CustomerTranslator.toDomain(legacyUser);
    }
}

/**
 * 翻译器：纯内存数据转换，不依赖 any 第三方组件
 */
class CustomerTranslator {
    public static Customer toDomain(LegacyUserDTO legacyUser) {
        // 将旧系统的 "U_TYPE_01" 复杂代码翻译为新系统清晰的 VIP 等级
        String newVipLevel = "U_TYPE_01".equals(legacyUser.getUType()) ? "GOLD" : "NORMAL";
        return new Customer(legacyUser.getUid(), newVipLevel);
    }
}

四、 总结

防腐层是微服务遗留系统改造演进中最有效的“隔离面罩”。

它通过**在基础设施层部署适配器与翻译器的物理组合，在物理上切断了新老系统的隐式脏关联**；并通过**100% 拒绝外部脏数据语义穿透的红线，护航了新微服务核心逻辑的绝对纯净度**。掌握防腐层的落地规范，是主导中大型遗留系统微服务重构、阻断业务模型退化混乱的核心看家本领！