settings.xml中localrepository配置不生效，需确保修改用户级文件${user.home}/.m2/settings.xml，路径用正斜杠或双反斜杠，且为绝对路径；改后旧jar不迁移，ide需重启或刷新，ci环境也需同步配置。
settings.xml 里 localRepository 配置不生效？先看位置对不对
Maven 只认特定路径下的 settings.xml，不是随便放个文件就管用。它优先级是：项目级（./maven/settings.xml）→ 用户级（${user.home}/.m2/settings.xml）→ 全局级（$M2_HOME/conf/settings.xml）。绝大多数人想改本地仓库路径，应该改用户级配置，否则新建项目或换账号后又回到默认路径。
- 确保你编辑的是
${user.home}/.m2/settings.xml（Windows 是C:\Users{用户名}.m2\settings.xml） - 如果该文件不存在，不要手动新建空文件——Maven 不会自动加载未被识别的 settings 文件，建议先运行一次
mvn -v让 Maven 自动生成基础配置 - 修改前确认
settings.xml根节点是<settings></settings>，且<localrepository></localrepository>在根节点内，不在<profiles></profiles>或其他嵌套块里
写死路径时 Windows 下反斜杠和空格引发的下载失败
localRepository 值必须是正斜杠或双反斜杠，单反斜杠会被 XML 解析器截断。比如 C:\Users\me.m2\repo 实际被读成 C:Usersme.m2epo，后续所有依赖下载都会报 Could not transfer artifact 错误，但错误日志里几乎不提示路径问题。
- 正确写法：用正斜杠
C:/Users/me/.m2/repo，或双反斜杠C:\Users\me\.m2\repo - 路径含空格（如
C:/Program Files/m2-repo）会导致部分插件（如maven-dependency-plugin）解析异常，建议避开 - Linux/macOS 虽无反斜杠问题，但若路径挂载在 NFS 或加密卷上，需确认 Maven 进程有读写权限，否则静默失败（只在首次 resolve 时卡住，无明确报错）
改完 localRepository 后旧 jar 还在默认路径？这是预期行为
Maven 不会自动迁移已下载的依赖。改路径只影响后续下载，之前下在 ${user.home}/.m2/repository 的包不会动，也不会被新构建引用——除非你没清空 IDE 缓存或没重启构建进程。
- 检查是否真用了新路径：执行
mvn help:effective-settings，看输出中localRepository的值是不是你设的 - IDEA/Eclipse 通常缓存了旧仓库路径，改完需重启 IDE 或刷新 Maven 项目（右键 → Maven → Reload project）
- 如果想迁移旧包，得手动复制整个
repository/目录过去，注意保留目录结构和文件权限（Linux/macOS 尤其要注意）
多模块项目里 localRepository 和 repository 标签别搞混
localRepository 是本地磁盘路径，只出现在 settings.xml；而 <repository></repository> 是远程仓库声明，写在 pom.xml 里，两者完全无关。有人误把远程地址填进 localRepository，结果 Maven 尝试在硬盘上创建形如 https:/repo.maven.apache.org/maven2/ 的目录，然后报 Failed to create directory。
-
localRepository必须是绝对路径，不能以http://、file://开头 - 它不支持变量替换（如
${user.home}），Maven 不解析 XML 实体以外的占位符 - 如果你用 CI 工具（Jenkins/GitLab CI），记得在 agent 上也配好对应用户的
settings.xml，否则构建仍走默认路径
改路径本身很简单，难的是路径写对、文件放对、工具同步对——三个“对”漏一个，就会发现依赖还是下到老地方，或者构建中途静默失败。
