Maven Install执行至java:VirtualDependsOn阶段大幅变慢的问题咨询

什么是java:VirtualDependsOn？ #

java:VirtualDependsOn是Java模块系统（JPMS）中的一个虚拟依赖标记，它不属于代码层面的直接依赖，而是用来声明模块间的逻辑依赖关系。

在模块化项目中，当某些模块不需要直接引入对方的代码，但需要在JVM模块解析阶段确保目标模块被加载、或者满足特定的逻辑运行条件时，就会用到这个概念。Maven在处理模块化项目的install阶段后期（比如模块验证、资源整合环节），会解析并应用这类虚拟依赖规则，保证模块的加载顺序和依赖逻辑符合项目配置。

这个日志本身通常是Maven处理JPMS模块的正常输出，并非错误提示。

处理方法 #

如果这个提示没有导致构建失败或卡住，一般无需特殊处理；若出现构建异常，可尝试以下步骤：

• 检查module-info.java配置：确认项目中所有模块的module-info.java文件里，是否存在错误的虚拟依赖声明（比如拼写错误的模块名、不合理的requires static或间接依赖配置）。
• 匹配Maven插件与JDK版本：确保maven-compiler-plugin、maven-jlink-plugin等与JPMS相关的插件版本，和项目使用的JDK版本兼容（比如JDK 11+对应的插件版本需支持模块化特性）。
• 清理Maven缓存并重新构建：执行命令 mvn clean install -U，强制清理本地缓存并更新依赖，避免缓存的旧模块信息导致解析异常。
• 检查IntelliJ模块化配置：在IntelliJ的「Project Structure → Modules」中，确认模块的JPMS设置是否正确，排查是否存在误配置的虚拟依赖项。
• 过滤日志（仅针对日志干扰）：如果只是不想看到该日志，可通过调整Maven日志级别实现，比如执行 mvn install -q（静默模式），或在Maven的settings.xml中配置日志过滤器，过滤掉该类概念应用的日志输出。

内容的提问来源于stack exchange，提问作者Liam