Maven 构建报错本地仓库文件被占用从 3.9 回退到 3.8 解决的完整记录环境Windows 10/11 IntelliJ IDEA Spring Boot 3.5 项目 Maven 3.9PATH 默认 本地仓库D:\maven-new-repo结论先行本地仓库里反复出现*.tmp文件被另一个程序占用导致 Maven 无法写入依赖清理无效后回退到 Maven 3.8.6 一次通过。-------个人经历仅供参考。一、问题现象使用 IDEA 或命令行执行mvn clean compile/mvn spring-boot:run时构建到一半就失败报错大致是[ERROR] Failed to execute goal ... (Could not resolve dependencies for project ...) [ERROR] Failed to collect dependencies at org.springframework.boot:spring-boot-starter-web:jar:3.5.0 [ERROR] The process cannot access the file because it is being used by another process - [Help 1]查看本地 Maven 仓库目录例如D:\maven-new-repo\...会发现存在大量*.tmp文件正是这些临时文件被占用导致 Maven 无法完成下载、改名、落盘等操作构建随之失败。二、排查过程1. 先怀疑是残留的 tmp 文件直接清理既然报错指向*.tmp文件第一反应是把它们全部删掉# 删除 Maven 本地仓库下所有临时文件谨慎操作仅删 .tmpGet-ChildItemD:\maven-new-repo-Recurse-Filter*.tmp|Remove-Item-Force清理后重新构建——依然失败而且更头疼的是这次锁的是另一个 artifact 的 tmp 文件。也就是说只要你一跑 Maven它下载依赖的过程中就会产生新的*.tmp然后立刻被另一个程序占用滚动式失败。清一个锁一个无穷无尽。2. 怀疑是进程或杀软在锁文件用任务管理器 /Get-Process检查并没有找到明显占用仓库的 Java 进程排除 IDEA 里正在跑的其它构建任务。可能的原因杀毒软件/Windows Defender 实时防护正在扫描下载中的 jar 包短暂锁住文件旧版 Maven 在下载校验checksum失败后留下的残留临时文件与新的下载任务冲突仓库目录权限/索引缓存异常。3. 尝试换一个全新仓库目录失败既然当前仓库有问题那就换一个干净的仓库路径试试mvn clean compile-Dmaven.repo.localD:/maven-new-repo-2结果在PowerShell下报参数解析错误-D参数被 PowerShell 拆词未能走通即使绕过新仓库也要全部重新下载依赖成本很高。4. 决定回退 Maven 版本到 3.8.6既然问题集中在 Maven 自身对本地仓库文件的操作上干脆换一个版本验证。本机恰好有一份Apache Maven 3.8.6直接用它的完整路径执行绕开 PATH 里的 3.9# 使用 3.8.6 的 mvn.cmd 完整路径执行D:\ApacheMaven\apache-maven-3.8.6\bin\mvn.cmd clean compile结果一次通过构建成功。三、解决方案与结果方案是否有效说明删除仓库中的*.tmp文件❌ 无效清完一个又锁另一个滚动失败换新仓库-Dmaven.repo.local❌ 未走通PowerShell 参数拆词问题且需全量重新下载回退 Maven 3.8.6✅有效一次构建成功后续编译、启动均稳定最终确定的标准做法此后一直沿用# 1. 每次构建前先清理本地仓库残留的 tmp 文件Get-ChildItemD:\maven-new-repo-Recurse-Filter*.tmp|Remove-Item-Force# 2. 固定使用 3.8.6 执行构建D:\ApacheMaven\apache-maven-3.8.6\bin\mvn.cmd clean package D:\ApacheMaven\apache-maven-3.8.6\bin\mvn.cmd spring-boot:run之后所有后端编译、启动操作都走 3.8.6再没有出现过一次文件占用报错。四、为什么 3.8.6 能解决原因分析以下为经验性分析供参考下载/校验流程差异3.9.x 对依赖下载后的校验与临时文件命名策略与 3.8.x 不同在文件被外部程序短暂锁定的 Windows 环境下更容易踩雷3.8.6 的重试与落盘机制更宽容。并发写文件方式不同新版 Maven 在某些场景下对仓库文件加独占锁与杀软扫描冲突时直接失败旧版处理更保守。运气因素切换到 3.8.6 时恰好锁文件的进程杀软扫描已结束后续也验证了清理 tmp 3.8.6组合一直稳定所以可复现性良好。如果不想回退版本也可以尝试把仓库目录加入杀软/Defender 的排除列表或换用mvn -Dmaven.repo.local指向全新目录Linux/macOS 下该参数不受 PowerShell 拆词影响。五、经验总结遇到文件被占用类构建错误先分清是进程占用还是杀软扫描锁如果清理后滚动复现基本可以判定是构建工具与环境的兼容问题而不是单纯的残留文件。Windows PowerShell 下-Dmaven.repo.local这类含的参数容易被拆词优先用完整路径调用mvn.cmd或改用cmd /c包裹。不要恋战一个 Maven 大版本不行花 5 分钟换一个小版本3.8/3.9 互切验证往往比反复清理更高效。固定可复现的构建环境把Maven 版本 仓库路径 前置清理命令写进团队的 README避免换人换机再踩同样的坑。补充如果你和我一样用 IDEA可以在Settings → Build Tools → Maven里把 Maven home 指定为 3.8.6 目录命令行和 IDE 保持一致双端都稳。