requires transitive 用于声明下游模块需自动获得上游模块公共API所依赖的第三方模块访问权，如返回值含ObjectMapper时必须使用，否则编译报错；它保障类型可见性，非Gradle传递依赖，且不可滥用。
Java 模块化系统（JPMS）通过 requires transitive 机制，让下游模块自动获得上游模块所依赖的第三方模块的访问权限，从而避免在多个地方重复声明同一依赖。关键不在于“省一行代码”，而在于让依赖关系成为可验证、可推导的契约。
什么时候必须用 requires transitive
当你的模块对外暴露了某个第三方模块的类型——比如方法参数、返回值、异常类型或 public 类中直接引用了 com.fasterxml.jackson.databind.ObjectMapper 或 org.slf4j.Logger——那么调用方就必须能访问该类型。否则编译会报错：“package not visible” 或 “cannot find symbol”。这时仅写 requires com.fasterxml.jackson.databind; 不够，必须加 transitive。
- ✅ 正确：下游模块引入你之后，可直接 new ObjectMapper() 或传入 Logger 实例
- ❌ 错误：只写普通 requires，下游还得自己再声明 jackson 或 slf4j，破坏封装且易版本不一致
module-info.java 中的典型写法
假设你开发了一个内部 HTTP 客户端模块 com.company.http，它用到了 OkHttp 和 Jackson，并把 ResponseEntity<T> 作为公共返回类型（其中泛型 T 可能是 Jackson 反序列化的对象）：
module com.company.http {
requires java.base;
requires transitive okhttp3; // 因为 public API 用了 OkHttpClient、Request 等
requires transitive com.fasterxml.jackson.databind; // 因为返回值含 ObjectMapper、JsonNode
exports com.company.http.api;
}
此时，任何 requires com.company.http; 的模块，无需额外声明 okhttp3 或 jackson，就能安全使用这些类型。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
和 Gradle/Maven 的传递依赖不是一回事
需要明确区分：
- Gradle 的 api/implementation 控制的是编译类路径（classpath）是否包含某依赖 —— 影响构建时能否编译通过、运行时能否加载类
- JPMS 的 requires transitive 控制的是模块读取权限（readability）和包可见性（accessibility）—— 影响编译期能否解析类型、运行时能否链接模块
两者可以并存：一个模块既要用 api 让 Gradle 传递 jar，也要用 requires transitive 让 JPMS 传递模块读取权。尤其在 Java 11+ 构建模块化应用时，缺一不可。
不滥用 transitive 的原则
transitive 是强契约，一旦声明，就等于承诺“这个依赖的 API 是我模块公共接口的一部分”。所以：
- 只对真正出现在 public API 签名中的依赖加 transitive
- 不要为内部工具类、日志实现、配置解析器等仅限本模块使用的依赖加 transitive
- 避免 transitive 传递链过长（如 A → transitive B → transitive C），这会扩大隐式耦合面
