Maven引入Jsoup依赖后提示package org.jsoup不存在求解决

问题重现 #

你提供的Java代码和Maven配置如下：

Java代码（存在导入缺失和异常未处理问题）：

import org.jsoup.Jsoup;
public class TestClass{

    public static void main(String[] args) {
        String url = "Google.com";
        Document document = Jsoup.connect(url).get();
    }
}

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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>TestFile</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>18</maven.compiler.source>
        <maven.compiler.target>18</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.jsoup</groupId>
            <artifactId>jsoup</artifactId>
            <version>1.17.2</version>
        </dependency>
    </dependencies>
</project>

运行时出现错误：package org.jsoup does not exist

解决步骤 #

1. 修复Java代码的基础问题

• 补充Document类的导入：import org.jsoup.nodes.Document;
• Jsoup.connect(url).get()会抛出IO异常，需要在main方法声明throws Exception或用try-catch处理
• 补充完整的URL协议和域名（否则Jsoup无法正常连接）

修复后的完整代码：

import org.jsoup.Jsoup;
import org.jsoup.nodes.Document;

public class TestClass{

    public static void main(String[] args) throws Exception {
        String url = "https://www.google.com";
        Document document = Jsoup.connect(url).get();
    }
}

2. 强制Maven重新拉取依赖

本地Maven仓库的依赖可能存在损坏或未下载完全的情况，执行以下命令强制更新：

mvn clean install -U

-U参数会强制刷新依赖缓存，确保Jsoup包完整下载到本地仓库。

3. 同步IDE的Maven配置

• 如果使用IDEA，点击右侧Maven面板的Reload All Maven Projects按钮，让IDE重新加载pom.xml配置
• 检查项目结构的Libraries目录，确认Jsoup的jar包已被Maven自动添加
• 移除之前手动添加到Modules中的Jsoup包，避免依赖冲突（Maven管理的依赖无需手动添加）

4. 排查本地仓库依赖文件

找到本地Maven仓库路径（默认是~/.m2/repository/org/jsoup/jsoup/1.17.2/），检查是否存在jsoup-1.17.2.jar：

• 如果文件不存在或大小异常，直接删除1.17.2目录，重新执行mvn install
• 确认目录下的.pom和.jar文件都完整

验证方法 #

执行Maven编译命令：

mvn compile

如果编译成功，再运行TestClass的main方法，即可正常使用Jsoup功能。

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