如何在IntelliJ IDEA Ultimate Edition中单步调试依赖库的本地修改代码

• 检查依赖库版本一致性
  首先确认你修改的依赖库pom.xml内<version>标签的取值，和主项目pom中引入该依赖的<version>完全相同。如果版本号不匹配，Maven会自动检索匹配版本的jar包，不会使用你本地编译的版本。如果是SNAPSHOT版本，先删除本地仓库~/.m2/repository路径下对应groupId/artifactId/version的整个目录，再重新执行mvn clean install编译依赖库，避免缓存的旧版本jar干扰。
• 调整IDEA模块依赖优先级
  打开IDEA的File → Project Structure → Modules，找到Spring Boot主项目模块，点击Dependencies标签，点击+号选择「Module Dependency」，选中你导入的依赖库模块，将该模块依赖的顺序调整到列表最顶部，优先级高于Maven依赖中的同名依赖，同时勾选该模块依赖右侧的「Export」选项后保存设置。
• 强制Maven使用本地依赖
  你可以选择两种方式实现：
  1. 打开主项目pom.xml，找到<repositories>配置节点，将对应Artifactory仓库的<releases>和<snapshots>的<updatePolicy>设置为never，临时禁止从远程拉取更新覆盖本地版本：

  <repository>
      <id>artifactory</id>
      <url>你的私有仓库地址</url>
      <releases>
          <updatePolicy>never</updatePolicy>
      </releases>
      <snapshots>
          <updatePolicy>never</updatePolicy>
      </snapshots>
  </repository>
  

  2. 执行主项目编译命令时添加-o参数启用离线模式：mvn clean install -o，完全禁止Maven访问远程仓库，强制使用本地已有的依赖。
• 排查传递依赖冲突
  如果该依赖是主项目通过其他依赖间接引入的，需要在主项目的<dependencyManagement>节点中显式声明该依赖的groupId、artifactId、version，强制所有位置使用你本地编译的对应版本，避免Maven自动仲裁使用更高版本的远程依赖。
• 清理IDEA缓存重启
  点击IDEA的File → Invalidate Caches...，勾选「Clear file system cache and local history」，点击Invalidate and Restart重启IDEA，重启后重新对主项目执行Maven Reload Project操作，再以Debug模式启动主项目即可。

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