根本原因是构建系统或运行时未识别、加载或传播自定义模块声明，导致依赖链断裂、运行时报错、ide无法索引等；需验证模块是否纳入构建图、正确发布到仓库、被环境识别为模块实体。
自定义模块标签（如 Maven 的 <dependency></dependency>、Unreal 的 PublicDependencyModuleNames、Java 25 的 requires）未被正确触发，根本不是“配置写没写”的问题，而是构建系统或运行时未能识别、加载或传播该声明——这会导致依赖链断裂、编译通过但运行时报错、IDE 无法索引、甚至模块静默失效。
mvn dependency:tree 看不见你的自定义模块？先确认它是否真被解析
很多开发者以为在 pom.xml 里加了 <dependency></dependency> 就万事大吉，但 Maven 实际解析依赖前会做两件事：校验本地仓库元数据 + 检查模块是否在 reactor 中。若你的自定义模块（如 ruoyi-message）未执行过 mvn install，或其 groupId/artifactId 与引用处不完全一致（注意大小写、横线），mvn dependency:tree 就根本不会把它当作有效依赖纳入树中。
- 执行
mvn clean install -pl :ruoyi-message -am（强制构建该模块及其上游） - 检查
~/.m2/repository/下对应路径是否存在pom.xml和.jar文件，且pom.lastupdate时间戳是否最新（过期或损坏会导致 IDEA 不识别，见后文） - 确保引用方的
<dependency></dependency>中<groupid></groupid>、<artifactid></artifactid>、<version></version>与被引用模块的pom.xml完全一致（复制粘贴比手敲更可靠）
Unreal 中 PublicDependencyModuleNames 不生效？检查模块是否参与构建图
在 MyModule.Build.cs 里写了 PublicDependencyModuleNames.AddRange(new string[] {"Core", "Engine"});，但编译仍报 Unknown type，大概率是因为该模块未被任何 .uproject 或 .Target.cs 显式启用。Unreal 构建系统只加载“被启动目标直接或间接依赖”的模块，不扫描所有 Source/ 子目录。
- 确认你的模块文件夹已放入
Source/下，并且名字与MyModule.Build.cs中类名一致（如class MyModule : ModuleRules→ 文件夹必须叫MyModule） - 检查
YourGame.Target.cs中的ExtraModuleNames是否包含你的模块名：ExtraModuleNames.Add("MyModule"); - 若模块仅被其他模块依赖（非直接启动目标），需确保依赖链上每个中间模块都正确声明了
PrivateDependencyModuleNames，否则构建图会断开
Java 25 module-info.java 的 requires 声明被忽略？验证模块是否被模块路径加载
requires 不生效，常见于两种场景：一是模块 JAR 未放在 --module-path 而是 -cp；二是模块未声明 Automatic-Module-Name（对传统 JAR）或未编译为模块化 JAR（缺少 module-info.class）。JVM 只对显式加入模块路径的、合法的模块才执行 requires 检查。
- 编译时用
javac --module-source-path src -d mods，而非普通javac -d out - 运行时必须用
java --module-path mods -m your.module.name/your.Main，不能用-cp - 若引用的是老 JAR（无
module-info.class），需在它的META-INF/MANIFEST.MF中添加Automatic-Module-Name: com.example.legacy，否则 JVM 会生成不稳定自动模块名，requires匹配失败
IDE 报红但 mvn 编译成功？别信 IDE 的缓存，重置它
IntelliJ IDEA 和 Eclipse 都会基于本地 Maven 仓库元数据构建索引。一旦 pom.lastupdate 损坏或时间戳异常（比如系统时间回拨、NFS 挂载延迟），IDE 就会拒绝加载对应模块的源码，即使 mvn compile 完全正常。
- 定位到本地仓库中你的模块路径，例如
~/.m2/repository/com/yourcompany/ruoyi-message/3.8.8/ - 删除该目录下的
pom.lastupdate文件（不是pom.xml！） - 在 IDEA 中点击
File → Project Structure → Modules，删掉对应模块再重新Import Module，或直接点击右上角Maven → Reload project - 极端情况下，可清空
~/.m2/repository下整个com/yourcompany目录，再重新mvn install
真正卡住人的从来不是“怎么写标签”，而是构建系统是否把那个标签当真——它取决于模块是否被纳入构建图、是否被正确发布到仓库、是否被运行时环境识别为模块实体。每一步漏掉一个隐式前提，标签就只是注释。
