添加json-simple Maven依赖后仍无法使用的技术问题

我在pom.xml中添加了json-simple依赖并重新加载Maven后，仍无法在项目中使用该库。导入时报错，类中无法调用相关方法。项目中其他依赖都能正常工作，我不是首次使用Maven，也尝试过其他JSON库，问题依旧。

我的pom.xml配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.zoohandlung</groupId>
  <artifactId>Main</artifactId>
  <version>1.0-SNAPSHOT</version>
  <name>ZoohandlungInfoLK</name>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<junit.version>5.9.2</junit.version>  </properties>

  <dependencies>
    <dependency>
      <groupId>org.openjfx</groupId>
      <artifactId>javafx-controls</artifactId>
      <version>20</version>
    </dependency>
    <dependency>
      <groupId>org.openjfx</groupId>
      <artifactId>javafx-fxml</artifactId>
      <version>20</version>
    </dependency>

<dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-api</artifactId>
      <version>${junit.version}</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-engine</artifactId>
      <version>${junit.version}</version>
      <scope>test</scope>
    </dependency>
<!-- 新增的依赖： -->
    <dependency>
      <groupId>com.googlecode.json-simple</groupId>
      <artifactId>json-simple</artifactId>
      <version>1.1.1</version>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.11.0</version>
        <configuration>
          <source>20</source>
          <target>20</target>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-maven-plugin</artifactId>
        <version>0.0.8</version>
      </plugin>
    </plugins>
  </build>
</project>

排查步骤 #

• 检查本地依赖是否下载完整：
  打开本地Maven仓库（默认路径~/.m2/repository/com/googlecode/json-simple/json-simple/1.1.1），确认存在json-simple-1.1.1.jar和json-simple-1.1.1.pom文件。如果缺失，执行命令强制更新：

  mvn clean install -U
  

• 清理IDE缓存并重新导入：

  • IntelliJ IDEA：点击File -> Invalidate Caches...，勾选清理文件系统缓存选项后重启，再重新导入Maven项目
  • Eclipse：执行Project -> Clean，右键项目选择Maven -> Update Project

• 排查依赖冲突：
  执行命令查看依赖树，确认是否有其他库覆盖了json-simple：

  mvn dependency:tree | grep json-simple
  

  若发现冲突，可在json-simple依赖中添加<exclusions>标签排除冲突依赖，或者调整版本号。

• 验证Java版本兼容性：
  json-simple 1.1.1是2012年的老版本，和Java 20可能存在兼容问题。可以尝试升级到最新维护版本（注意groupId已变更）：

  <dependency>
      <groupId>com.github.cliftonlabs</groupId>
      <artifactId>json-simple</artifactId>
      <version>3.1.1</version>
  </dependency>
  

• 检查Maven构建状态：
  执行命令编译项目，看是否有明确的编译错误：

  mvn clean compile
  

  若命令行编译正常但IDE报错，说明是IDE的Maven配置问题，检查是否使用了正确的Maven安装路径和settings.xml。

• 确认导入语句正确：
  确保导入的是json-simple的正确包，比如：

  import org.json.simple.JSONObject;
  import org.json.simple.JSONArray;
  

  避免和其他JSON库（如org.json）的包名混淆。

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