1. 项目背景与核心挑战最近在做一个餐饮类SaaS系统的聚合平台项目需要对接美团、饿了么、口碑等主流平台的霸王餐活动接口。这些平台提供的API文档五花八门——有的用RESTful有的还在用SOAP返回的数据结构更是千奇百怪有的用XML有的用多层嵌套JSON甚至连同个字段在不同平台都用了不同命名比如优惠金额美团叫discountAmount饿了么用couponValue。更头疼的是业务方要求所有接口必须统一成我们内部的标准格式且要支持动态增减对接平台。如果直接写if-else硬编码代码会变成这样if(meituan.equals(platform)){ // 美团特有解析逻辑 } else if(eleme.equals(platform)){ // 饿了么特有逻辑 }这种写法至少有三大致命伤每对接新平台就要修改核心业务代码违反开闭原则平台差异逻辑散落在各处维护成本指数级上升单元测试难以覆盖所有分支2. 适配器模式解决方案设计2.1 模式选型分析针对这种多源异构接口统一接入场景适配器模式Adapter Pattern是最佳选择。它的核心思想就像电源转换插头——不改变原有接口通过中间层做兼容转换。在我们的场景中目标接口Target定义统一的霸王餐活动标准DTO和调用规范适配器Adapter实现各平台API到标准接口的转换逻辑被适配者Adaptee各平台原生的API客户端2.2 类结构设计// 标准目标接口 public interface FreeMealService { ListStandardActivity getLiveActivities(); boolean joinActivity(String activityId); } // 抽象适配器可选 public abstract class AbstractPlatformAdapter implements FreeMealService { protected PlatformClient client; public AbstractPlatformAdapter(PlatformClient client) { this.client client; } // 公共方法可以在这里实现 } // 美团适配器 public class MeituanAdapter extends AbstractPlatformAdapter { Override public ListStandardActivity getLiveActivities() { // 调用美团原生API MeituanResponse response client.getTuanGouList(); // 数据转换 return response.getItems().stream() .map(item - new StandardActivity( item.getId(), item.getDiscountAmount(), convertTime(item.getExpireTime()) )).collect(Collectors.toList()); } private LocalDateTime convertTime(String meituanFormat) { // 美团特有时间格式处理 } } // 饿了么适配器 public class ElemeAdapter extends AbstractPlatformAdapter { // 实现类似逻辑但处理饿了么特有格式 }2.3 动态适配器管理通过简单工厂Spring依赖注入实现运行时适配Service public class AdapterFactory { Autowired private MapString, FreeMealService adapters; public FreeMealService getAdapter(String platform) { return Optional.ofNullable(adapters.get(platform Adapter)) .orElseThrow(() - new IllegalArgumentException(Unsupported platform)); } } // 使用示例 FreeMealService adapter factory.getAdapter(meituan); ListStandardActivity activities adapter.getLiveActivities();3. 关键实现细节与坑点3.1 统一异常处理机制各平台API的错误码需要映射到统一体系public enum PlatformError { MEITUAN_404(1001, 活动不存在), ELEME_500(1002, 系统繁忙); private final int unifiedCode; private final String message; // 转换方法 public static PlatformError from(String platform, String originCode) { // 实现各平台错误码映射 } } // 在适配器中统一处理 try { return client.getFromPlatform(); } catch (PlatformException e) { throw new UnifiedException( PlatformError.from(platform, e.getCode()), e.getMessage() ); }3.2 性能优化技巧缓存策略对getLiveActivities()这类读多写少的接口采用两级缓存Cacheable(value activities, key #platform) public ListStandardActivity getLiveActivities(String platform) { // 实际调用 }批量请求美团API限制单次最多查询50个活动需要分页并行请求ListCompletableFutureMeituanResponse futures IntStream.range(0, totalPage) .mapToObj(page - CompletableFuture.supplyAsync( () - client.getPage(page), executor)) .collect(Collectors.toList()); return CompletableFuture.allOf(futures.toArray(new CompletableFuture[0])) .thenApply(v - futures.stream() .flatMap(f - f.join().getItems().stream()) .collect(Collectors.toList()));3.3 监控埋点设计在抽象适配器中加入统一监控public abstract class AbstractPlatformAdapter { Override public ListStandardActivity getLiveActivities() { long start System.currentTimeMillis(); try { ListStandardActivity result doGetActivities(); Metrics.recordSuccess(platform, System.currentTimeMillis() - start); return result; } catch (Exception e) { Metrics.recordError(platform, e.getClass().getSimpleName()); throw e; } } protected abstract ListStandardActivity doGetActivities(); }4. 实际效果与扩展思考上线后系统表现新平台接入时间从3人日缩短到0.5人日核心业务代码保持稳定半年内零修改异常排查效率提升60%统一错误码功劳后续优化方向引入配置中心将字段映射规则外置为JSON配置{ meituan: { activityId: id, discount: discountAmount, timeFormat: yyyy-MM-dd HH:mm:ss } }增加自动化mock测试框架用YAML文件描述请求-响应样例结合策略模式处理平台特有的业务规则如美团需要校验用户地理位置5. 血泪教训记录时间格式陷阱美团返回UTC时间戳饿了么用GMT字符串口碑却是本地时区。必须统一转为系统时区// 不要直接用SimpleDateFormat.parse() ZonedDateTime utcTime Instant.ofEpochMilli(timestamp) .atZone(ZoneId.of(UTC)); return utcTime.withZoneSameInstant(ZoneId.systemDefault());金额单位不统一有的平台用元如12.5有的用分如1250。建议在适配器层统一转为BigDecimal// 饿了么适配器 BigDecimal amount new BigDecimal(couponValue).divide(new BigDecimal(100)); // 美团适配器 BigDecimal amount new BigDecimal(discountAmount);空字段处理某些平台返回null有些返回NULL还有的返回-。必须统一过滤String safeGet(String value) { return StringUtils.isEmpty(value) || NULL.equalsIgnoreCase(value) ? null : value; }这个方案在日请求量百万级的系统中稳定运行了一年多期间无缝接入了5个新平台。最大的体会是好的架构设计不是过度设计而是找到变化的方向然后在这些变化点上做抽象。