Jenkins 构建速度慢通常是因为每次构建都重新下载依赖包。最推荐的处理方向是保留工作空间中的依赖缓存目录，并配置私有镜像源，适用场景为 Maven、npm、pip 等包管理项目，风险边界是需注意磁盘空间增长和依赖版本冲突。
先说结论：优化 Jenkins 依赖缓存的核心在于避免重复下载，通过持久化依赖目录和使用内部镜像源来减少网络 IO 耗时。
- 先定位：查看构建日志，确认耗时是否主要集中在依赖下载阶段。
- 先做：配置流水线保留依赖缓存目录，禁止每次构建前清理工作空间。
- 再验证：对比优化前后的构建时长，并监控服务器磁盘空间使用情况。
命令速用版
以下 Pipeline 片段展示了如何在 Jenkins 中缓存 Maven 依赖目录，其他包管理工具可参考类似逻辑指定缓存路径。
pipeline {
agent any
options {
// 禁止自动清理工作空间，保留依赖缓存
disableConcurrentBuilds()
}
stages {
stage('Build') {
steps {
// 显式指定 Maven 本地仓库路径，避免使用默认临时目录
sh 'mvn clean install -Dmaven.repo.local=./m2_repo'
}
}
}
}如果使用 Docker 代理构建，建议在 Dockerfile 中分层缓存依赖层，或在 Jenkins 卷挂载中持久化宿主机的依赖目录。
为什么会这样
构建慢的根本原因是网络 IO 瓶颈和重复劳动。Jenkins 默认配置为了环境纯净，往往会在构建前清理工作空间，导致 Maven、npm 等工具每次都要从远程仓库重新下载所有依赖包。公共仓库网络不稳定且距离远，进一步拉长了下载时间。通过本地缓存和私有镜像，可以将网络请求转化为磁盘读取，显著减少等待时间。
分步处理
步骤 1：检查工作空间清理策略
进入 Jenkins 任务配置页面，查找“构建后操作”或 Pipeline 脚本中的 cleanWorkspace 步骤。如果存在强制清理命令，需修改为仅清理编译产物，保留依赖目录。适用场景为所有基于包管理器的项目。操作动作是注释掉 cleanWorkspace 或配置排除规则。风险边界是磁盘空间可能随构建次数增加而变大。
步骤 2：配置依赖缓存路径
在构建脚本中显式指定依赖缓存目录。例如 Maven 使用-Dmaven.repo.local，npm 使用 npm config set cache。操作动作是修改构建命令或配置文件。验证结果是构建日志中显示正在使用指定目录。风险边界是不同任务间共享缓存可能导致权限冲突，建议任务独立目录或做好权限控制。
步骤 3：配置私有镜像源
在公司内网搭建 Nexus 或 Artifactory，或在构建节点配置 mirrors 指向国内公开镜像。操作动作是修改 settings.xml 或.npmrc 文件。验证结果是下载速度提升且构建更稳定。风险边界是镜像源同步延迟可能导致找不到最新包，需确保镜像同步策略可靠。
怎么验证是否生效
查看 Jenkins 构建日志的时间戳，对比依赖下载阶段的耗时变化。如果之前需要几分钟下载，现在变为几秒或显示“Downloading from local”，则说明缓存生效。同时检查构建节点磁盘使用率，确认缓存目录大小在预期范围内。公开资料中没有看到可靠的量化数据，具体提升幅度取决于项目依赖大小和网络环境。
常见坑
- 磁盘空间爆炸：长期不清理缓存会导致构建节点磁盘满，需配置定期清理策略或磁盘配额。
- 依赖版本冲突：缓存了错误的依赖版本可能导致构建成功但运行失败，需确保依赖锁定文件（如 package-lock.json）提交到代码库。
- 权限问题：多个构建任务共享同一缓存目录时，可能因用户权限不同导致写入失败，建议每个任务使用独立缓存子目录。
常见问题
每次构建都必须清理工作空间吗？
不需要。为了缓存依赖，应保留依赖目录，仅清理编译生成的二进制文件或临时产物。
Docker 构建如何缓存依赖？
在 Dockerfile 中将安装依赖的步骤放在复制源代码之前，利用 Docker 层缓存机制，或挂载宿主机依赖目录到容器内。
Maven 和 npm 缓存策略有什么不同？
Maven 默认使用用户主目录下的.m2 仓库，npm 默认使用全局缓存目录，两者都需要在 Jenkins 中显式指定路径以确保持久化。
参考来源
- Jenkins 官方文档，Pipeline Syntax，https://www.jenkins.io/doc/book/pipeline/syntax/
- Apache Maven 官方文档，Settings Reference，https://maven.apache.org/settings.html