核心是用接口抽象与适配器模式隔离第三方SDK：定义业务语义接口（如MessageSender）、封装参数与异常、为各SDK实现独立适配器、运行时依赖注入、统一错误码映射与响应结构。
核心是用接口抽象 + 适配器模式把第三方 SDK 的具体实现关进“盒子”，让业务代码只依赖你定义的契约，不碰 SDK 的任何类、方法或异常。
定义稳定接口，不暴露 SDK 细节
先设计一组与业务语义对齐的接口，比如 MessageSender、UserManager，方法签名只包含业务参数（如 sendText(String toUserId, String content)），不出现 SendMessageRequest 或 IMResult 这类 SDK 原生类型。接口不声明 throws 第三方异常（如 ClientException），统一用自定义运行时异常（如 IMServiceException）表达失败。
为每个 SDK 实现独立适配器
每个第三方 SDK（如腾讯云 IM、融云、环信）写一个单独的适配器类，实现上述接口：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 参数映射：把通用入参转成该 SDK 要求的 DTO，比如把
toUserId封装进TIMSendMessageReq - 调用委托：真正调用 SDK 方法，但仅在此处引入其包和类型
- 异常转换：捕获 SDK 的所有受检/非受检异常，统一转为你的
IMServiceException，保留原始 cause（用带 Throwable 的构造器） - 空值与默认处理：某 SDK 不支持撤回消息，就直接抛
UnsupportedOperationException，不静默吞掉行为差异
依赖倒置，运行时注入实现
业务层通过接口编程，不 new 具体适配器。用 Spring 的 @Qualifier 或工厂方法控制选用哪个实现：
立即学习“Java免费学习笔记（深入）”；
- 配置文件指定当前启用的 SDK 类型（如
im.provider=tencent） - 容器根据配置加载对应适配器 Bean
- 新增 SDK 只需加一个新适配器类 + 配置项，不改已有接口和业务逻辑
隔离异常与响应结构
不让 SDK 的错误码、HTTP 状态、原始 JSON 响应穿透到上层：
- 适配器内部解析 SDK 返回，提取成功标志、业务数据、错误信息
- 将 SDK 的
40001、70002等错误码映射为你自己的枚举（如ErrorCode.USER_NOT_FOUND） - REST 接口返回统一的
Result<T>结构，状态码由网关或 Controller 层按业务异常类型决定（如ParamInvalidException → 400，IMServiceException → 500）
