必须加 transitive 当模块api类型（如方法参数、返回值）直接引用依赖模块的公开类型时，否则下游编译失败；module-info.java中须写为 requires transitive 模块名;，不可颠倒顺序。
Java 9 模块系统中，transitive 是 requires 的修饰符，用于控制依赖是否向下游模块“透出”。它不自动导入类、不改变变量作用域，只决定编译期和运行时模块图中类型可见性的传递范围。
什么时候必须加 transitive
当你的模块对外暴露的 API 类型（方法参数、返回值、异常、泛型边界等）直接引用了某个依赖模块的公开类型时，就必须用 requires transitive。否则下游模块编译会失败。
- 比如你写了一个 JSON 工具类，方法返回
ObjectMapper（来自 Jackson），那com.fasterxml.jackson.databind就得标记为transitive - 再如 HTTP 客户端模块导出了一个接口，其方法参数是
HttpRequest（来自java.net.http），这个依赖本身已是 JDK 内置模块，无需 transitive；但若用了slf4j.api作为日志门面并出现在方法签名里，就得加 transitive - 普通内部日志记录（仅在 private 方法里调用
Logger.info()）则用普通requires即可
怎么写 module-info.java
在 module-info.java 文件中，把需要透出的依赖写成 requires transitive 模块名;。注意语法顺序不能颠倒，transitive 必须紧跟 requires 后面。
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 正确写法：
requires transitive com.fasterxml.jackson.databind; - 错误写法：
requires com.fasterxml.jackson.databind transitive;或transitive requires ... - 多个传递依赖可分行写，也可合并（不推荐）：
requires transitive A; requires transitive B;
常见误用与后果
滥用 transitive 会让下游模块“被迫”看到你不希望它接触的类型，引发命名冲突、版本干扰或封装泄露。
- 把工具类模块（如内部字符串处理）设为 transitive：下游可能意外使用到你不保证兼容性的内部 API
- 对
java.logging加 transitive：虽然它本身是 JDK 模块，但若你的模块只是内部打日志，没必要让使用者也“继承”这个依赖 - 混淆构建层与模块层：Maven 的
<scope>provided</scope>不等于requires transitive，两者作用域不同，不能互相替代
验证是否生效
最直接的方式是写一个新模块，只声明 requires 你的模块名;，然后尝试在该模块中直接 new 或 import 被标记为 transitive 的依赖里的公开类。如果编译通过，说明传递成功。
- 例如下游模块写了
requires com.example.jsonlib;，接着就能直接写new ObjectMapper();—— 这就表示com.fasterxml.jackson.databind正确透出了 - 如果报错 “package com.fasterxml.jackson.databind does not exist”，说明 transitive 没加，或模块名拼写错误，或目标模块未导出对应包
- 运行时可通过
java --list-modules | grep xxx查看实际加载的模块列表
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
