Java单元测试模拟第三方SDK的核心是隔离依赖、控制行为、覆盖边界，应只mock直接调用的接口方法，优先依赖接口、注入mock实例，预设成功/失败/超时等响应，并绕过不可控初始化。
Java 单元测试中模拟复杂第三方 SDK，核心是隔离依赖、控制行为、覆盖边界。不能让测试跑真实网络调用、读配置、初始化外部服务——这会让测试变慢、不稳定、难调试。关键不是“怎么 mock”，而是“在哪一层 mock”和“mock 到什么程度”。
明确被测对象边界，只 mock 真正的第三方交互点
SDK 通常封装了协议、重试、序列化、连接池等逻辑。但单元测试不验证 SDK 本身是否正确，而是验证你的代码如何使用它。因此只需 mock 你直接调用的接口方法，而不是整个 SDK 初始化过程。
- 如果 SDK 提供了面向接口的设计（如
NotificationService接口），优先依赖该接口，测试时用@Mock注入模拟实现 - 若 SDK 只有具体类（如
CloudStorageClient），可用 Mockito 的mock(CloudStorageClient.class)，但需确保其构造不触发副作用（如静态块初始化、自动连接） - 避免 mock 工具类、工具方法（如
buildCacheKey()这类纯函数），它们应直接调用、无需替换
用行为驱动方式预设响应，覆盖成功、失败、超时、空值等典型路径
第三方 SDK 行为复杂，往往返回异步结果、抛受检异常、或内部重试后才失败。测试时要主动构造这些场景，而不是等待真实环境复现。
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 同步方法：用
when(client.upload(any())).thenReturn("success-id")或thenThrow(new UploadException("timeout")) - 异步方法（如返回
CompletableFuture<Result>）：
✅ 正常完成：thenReturn(CompletableFuture.completedFuture(result))
✅ 异常完成：thenReturn(CompletableFuture.failedFuture(new ServiceException("auth failed")))
✅ 模拟延迟：thenReturn(CompletableFuture.supplyAsync(() -> { sleep(200); return result; }, testExecutor))（配合单线程testExecutor） - 对可能返回
null、空集合、空字符串的 SDK 方法，显式 mock 这些返回值，并验证你的代码能否安全处理
绕过不可控初始化，用可配置构造或工厂注入替代硬编码
很多 SDK 在实例化时会读系统属性、连远程配置中心、启动后台线程——这些在单元测试里必须禁掉。
立即学习“Java免费学习笔记（深入）”；
- 把 SDK 客户端作为依赖项注入（构造器注入或 setter 注入），而非在业务类里
new CloudClient() - 提供测试专用构造器或 Builder，允许传入已 mock 好的底层组件（如 mock 的
HttpClient、ExecutorService） - 若 SDK 强制静态初始化（如
AwsSdkUtils.init()），可用 PowerMockito（谨慎）或更推荐的方式：抽离初始化逻辑到可替换的策略类，测试时注入空策略
结合轻量级内存模拟库，替代部分 SDK 的完整行为
对 AWS、DynamoDB、S3 等高频依赖，直接 mock 接口易遗漏细节（如分页逻辑、条件更新语义）。此时可引入专用模拟库：
-
mock-aws-java-sdk：内存级 S3/DynamoDB 模拟，支持真实 SDK 调用，无需改业务代码 -
localstack（集成测试阶段）：本地运行的轻量云服务模拟，适合验证 SDK 配置与协议兼容性 -
embedded-redis、h2：对 Redis/DB 类 SDK，用嵌入式替代远程依赖，保持协议一致但完全可控
