Maven引入Apache Commons Codec 1.15依赖失败，寻求解决办法

确认依赖配置有效性 #

你使用的依赖配置是完全正确的，与Maven中央仓库的记录一致：

<dependency>
    <groupId>commons-codec</groupId>
    <artifactId>commons-codec</artifactId>
    <version>1.15</version>
</dependency>

问题出在依赖拉取或IDE同步环节，可按以下步骤排查解决：

具体修复步骤 #

• 强制Maven刷新依赖
  在项目根目录打开终端，执行命令强制Maven绕过本地缓存，从远程仓库重新拉取依赖：

  mvn clean install -U
  

  -U参数会强制更新所有依赖的快照与发布版本，能解决本地缓存损坏或缺失导致的依赖找不到问题。

• 同步IDE与Maven依赖

  1. 打开IntelliJ IDEA右侧的Maven工具窗口
  2. 点击工具栏的刷新按钮（圆形箭头图标），触发IDE重新读取pom.xml并同步依赖
  3. 若仍无效，执行File → Invalidate Caches...，选择Invalidate and Restart，重启IDE后再次同步

• 检查Maven镜像配置
  打开本地Maven的settings.xml文件（路径通常为~/.m2/settings.xml或Maven安装目录下的conf/settings.xml）：

  • 如果配置了自定义镜像，确认该镜像仓库包含commons-codec:commons-codec:1.15版本
  • 可临时注释自定义镜像，使用默认中央仓库测试是否能正常拉取依赖

• 手动安装依赖到本地仓库
  若以上方法均无效，可手动安装依赖：

  1. 获取commons-codec-1.15.jar包
  2. 在jar包所在目录执行以下Maven命令，将其安装到本地仓库：

  mvn install:install-file -Dfile=commons-codec-1.15.jar -DgroupId=commons-codec -DartifactId=commons-codec -Dversion=1.15 -Dpackaging=jar
  

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