requires transitive 的核心是让下游模块自动继承工具链模块导出api中涉及的第三方类型可见性与编译期可访问性，而非传递变量；仅对出现在导出包公共api签名（如方法返回值、参数类型）中的依赖才应标记transitive，配合精确exports控制暴露边界，避免实现细节泄露。
用 requires transitive 简化工具链模块依赖，核心是让下游模块“自动继承”你封装好的基础能力，不用自己再写一遍 requires。关键不在透传变量（Java 模块系统不传递变量），而在于透传**类型可见性与编译期可访问性**——即让下游能直接使用你 API 中涉及的第三方类型。
明确哪些依赖该标记为 transitive
只对那些出现在你 导出包的公共 API 签名中 的依赖做 transitive 声明。例如：
- 方法返回值是
com.fasterxml.jackson.databind.JsonNode→ 需要requires transitive com.fasterxml.jackson.databind - 接口参数含
org.slf4j.Logger→ 需要requires transitive org.slf4j.api - 仅在私有
internal包里用Apache Commons Lang做字符串处理 → 用普通requires即可
工具链模块典型结构示例
假设你开发一个通用 HTTP 客户端封装模块 com.example.httpkit，它对外提供 HttpClientService 接口，并基于 okhttp3 实现：
module com.example.httpkit {
requires java.net.http;
requires transitive okhttp3;
requires transitive slf4j.api;
exports com.example.httpkit.api;
}
下游模块只需声明：
module com.example.app {
requires com.example.httpkit; // 自动获得 okhttp3 和 slf4j.api 的访问权
}
这样，com.example.app 就能直接 new OkHttpClient 或调用 Logger.info()，无需重复 require。
避免透传污染：控制导出边界
transitive 不等于“全部放开”。务必配合 exports 精确控制暴露范围：
- 只
exports com.example.httpkit.api，不导出internal或impl包 - 即使用了
requires transitive okhttp3，只要没把okhttp3.*包导出，下游仍不能直接 importokhttp3.Request—— 除非你的 API 类型（如返回值）本身来自该包 - 若想彻底隔离实现细节，可将 okhttp3 封装进自己的 DTO 或适配器类中，此时就不需要 transitive
构建时验证是否生效
光写对 module-info 不够，要实测下游能否编译通过：
- 在下游模块中尝试写一行：
JsonNode node = objectMapper.readTree(json); - 如果编译报错 “package com.fasterxml.jackson.databind does not exist”，说明 transitive 未生效或 jdk 版本/构建工具（如 Maven 编译插件）未启用模块路径支持
- Maven 中需确认
maven-compiler-plugin版本 ≥ 3.8.0，且配置了<release>9</release>或更高
