升级IntelliJ IDEA 2024.1.6后Java项目编译失败：org.jsoup依赖异常

以下是针对该问题的具体排查和解决步骤：

• 检查本地Maven仓库的jsoup依赖完整性
  找到本地Maven仓库中jsoup的存储路径（默认路径为~/.m2/repository/org/jsoup/jsoup/1.18.1），查看该目录下是否存在jsoup-1.18.1.jar以及对应的.pom、.sha1等校验文件。如果文件缺失或损坏，直接删除整个1.18.1目录，然后执行以下操作：

  • 在IDEA右侧Maven面板中依次执行Clean和Install
  • 或者在项目根目录打开终端，运行命令：mvn clean install -U（-U参数强制Maven更新依赖）

• 验证IDEA的Maven配置正确性
  打开File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven，确认以下配置：

  • Maven home directory是否指向你本地安装的Maven版本（而非IDEA内置Maven，部分情况下内置版本会出现依赖拉取异常）
  • User settings file和Local repository路径是否与实际一致

• 检查项目Maven Profile激活状态
  查看IDEA右侧Maven面板的Profiles区域，确认当前激活的Profile是否会影响依赖加载（尽管你的pom.xml中profile未修改依赖配置，但仍需排除该可能性）。若有不必要的Profile激活，可取消勾选。

• 强制重新导入所有Maven依赖
  在IDEA右侧Maven面板中，点击顶部的「Reload All Maven Projects」按钮（双循环箭头图标），或右键项目根目录选择Maven -> Reimport，确保所有依赖被重新识别。

• 手动添加jsoup依赖到项目模块
  打开File -> Project Structure -> Modules，选中对应模块切换到Dependencies标签页，若未看到jsoup依赖，点击+ -> Library -> Maven，搜索org.jsoup:jsoup:1.18.1并添加到项目中。

• 彻底清理IDEA缓存并重启
  执行File -> Invalidate Caches...，选择Invalidate and Restart，彻底清除IDEA缓存后重启，解决可能存在的缓存冲突问题。

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