
本文针对构建 Spring Boot 2.2.9.RELEASE 源码时因 download-maven-plugin 下载文档资源失败导致的构建中断问题,提供简洁有效的绕过方案与实践建议。
本文针对构建 spring boot 2.2.9.release 源码时因 `download-maven-plugin` 下载文档资源失败导致的构建中断问题,提供简洁有效的绕过方案与实践建议。
在本地构建 Spring Boot 2.2.9.RELEASE 源码时,执行命令 mvn clean install -DskipTests -Pfast 常会触发如下错误:
Failed to execute goal com.googlecode.maven-download-plugin:download-maven-plugin:1.4.2:wget (unpack-doc-resources) on project spring-boot-gradle-plugin: IO Error: Could not get content -> [Help 1]
该错误本质是 spring-boot-gradle-plugin 模块在 fast 构建 Profile 下,通过 download-maven-plugin 尝试拉取远程文档资源(如 Gradle DSL 参考)时网络超时或资源不可达所致——尤其在无稳定外网访问、代理配置异常或 Maven 仓库镜像未同步插件依赖的场景下高频发生。
根本原因并非代码缺陷,而是构建流程中非核心模块对网络资源的强依赖。spring-boot-gradle-plugin 属于 Spring Boot 工具链模块,其主要服务于 IDE 集成与 Gradle 构建增强,并非运行时必需组件;而 unpack-doc-resources 目标仅用于生成开发文档资源,对源码编译与单元测试无实质影响。
✅ 推荐解决方案(安全、轻量、可复现):
直接从构建中移除该模块,避免触发下载逻辑:
- 进入 Spring Boot 源码根目录,定位到
spring-boot-project/spring-boot-tools/pom.xml; - 找到
节点,删除包含spring-boot-gradle-plugin的行,例如:<!-- 删除这一行 --> <module>spring-boot-gradle-plugin</module>
- 保存文件后,重新执行构建命令:
mvn clean install -DskipTests -Pfast
⚠️ 注意事项:
- 此操作不影响核心框架(如
spring-boot,spring-boot-autoconfigure)的编译与测试; - 若后续需调试 Gradle 插件功能,可单独构建该模块(
cd spring-boot-gradle-plugin && mvn clean install -DskipTests),并手动配置代理或更换download-maven-plugin版本(如升级至 1.6.7+ 支持重试机制); - 建议在
~/.m2/settings.xml中配置国内镜像(如阿里云)并启用全局代理(如需),以提升其他依赖下载稳定性。
该方法已在多个离线/受限网络环境验证有效,兼顾构建效率与工程可控性,是 Spring Boot 源码贡献者常用的轻量级规避策略。











