Gradle引入Guava依赖后JavaFX项目无法识别类符号问题排查

你的项目启用了Java 9+ 引入的JPMS模块化机制（从build.gradle中配置的mainModule字段就能确认），并非传统的classpath类路径项目。仅在Gradle依赖块中声明Guava，不会自动将Guava纳入模块的可访问范围，这就是IDE提示找不到符号、编译阶段无法识别Guava类的核心原因，和你Gradle依赖的写法本身无关。
你之前手动在Project Structure中硬加Guava jar包的操作反而可能造成依赖冲突，先把手动添加的条目全部删掉，所有依赖统一交给Gradle管理即可。

• 打开src/main/java路径下的module-info.java模块描述文件，在现有requires声明块中新增Guava的模块依赖，注意Guava的JPMS模块名固定为com.google.common，参考配置如下：

module me.tisleo.jpasswordmanager {
    // 保留你原有的所有requires声明，不要修改
    requires javafx.controls;
    requires javafx.fxml;
    requires org.controlsfx.controls;
    requires org.kordamp.bootstrapfx.core;
    // 新增这一行即可
    requires com.google.common;

    // 保留你原有的opens、exports配置，不要修改
    opens me.tisleo.jpasswordmanager to javafx.fxml;
    exports me.tisleo.jpasswordmanager;
}

• 保存文件后先刷新Gradle配置，如果IDE依然提示找不到符号，依次执行两个操作清缓存：
  1. 在Gradle任务面板执行clean任务，清空历史构建缓存
  2. 打开IDEA菜单选择File -> Invalidate Caches...，勾选清除项目索引选项后重启IDEA，等索引重新构建完成即可正常识别Guava类。

如果做完上述操作还是无法识别依赖，在项目根目录执行对应命令检查Gradle是否成功拉取Guava包：

• macOS/Linux环境：./gradlew dependencies --configuration compileClasspath
• Windows环境：gradlew.bat dependencies --configuration compileClasspath
  查看输出的依赖树中是否存在com.google.guava:guava:31.1-jre条目，如果不存在，检查本地网络、Maven仓库配置，确保依赖可以正常从中央仓库下载即可。
  另外配置正确后，jlink插件也能自动识别Guava模块，不会影响后续的本地镜像打包流程。

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