如何在Intellij的Maven JavaFX项目中正确导入Gson并解决运行报错

问题排查及解决步骤 #

1. 解决Gson运行时类找不到的问题 #

• 移除重复依赖：你同时通过「项目结构手动导入」和「pom.xml声明」两种方式添加了Gson依赖，二者存在冲突。先进入「文件 -> 项目结构 -> 库」，找到手动导入的com.google.code.gson条目，点击减号删除，仅保留pom.xml管理依赖。
• 同步Maven依赖：点击IDEA右侧Maven侧边栏的刷新按钮，等待依赖同步完成，确认pom.xml中Gson依赖无飘红报错。
• 修正运行配置：打开右上角运行配置下拉框，选择「编辑配置」，找到你当前使用的JavaFX运行配置，点击「修改选项」，勾选「将依赖项添加到类路径」，确保Gson包被包含到运行时环境中。
• 补充模块化配置：由于你使用了Java模块化（存在module-info.java），Gson序列化反序列化需要反射访问你的实体类，需要在module-info.java中添加对应开放规则。如果你的实体类存放在com.example.democtc.entity包下，添加如下配置：

  opens com.example.democtc.entity to com.google.gson;
  

  如果实体类直接放在com.example.democtc包下，直接开放该包即可。

2. 解决javafx.beans重复读取的提示 #

该提示是因为项目中存在多份版本不一致的javafx.base包：

• 检查pom.xml中所有javafx相关依赖，确保所有依赖的版本号完全统一。
• 进入「文件 -> 项目结构 -> 库」，删除手动导入的JavaFX相关库，仅保留Maven同步的JavaFX依赖，刷新Maven后提示即可消失。

验证方案 #

可以直接在IDEA终端执行Maven命令启动项目，避开本地运行配置的问题：

mvn clean javafx:run

如果命令启动正常，则说明仅IDEA本地运行配置有误，直接使用Maven命令启动即可，也可以基于该命令新增一个Maven运行配置替代原有JavaFX运行配置。

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