构建问题

Java 构建失败—构建依赖缺失

Flow在Java构建时需要下载settings.xml依赖文件，Flow提供阿里云 Maven 公库作为下载源，如果您的项目涉及自己定义创建的不规则依赖文件，Flow 构建会失败，报错信息如下：

为了让 Flow 可以正常下载您项目构建所依赖的文件完成构建，您可以通过以下三种方式完成配置。

Java 构建缓慢—未设置有效缓存目录

由于 Flow 流水线执行时，每个任务节点都会创建新的构建环境，构建完后会销毁，为解决流水线运行过程构建依赖反复下载提升整体构建效率的问题，Flow 提供了自定义缓存功能。用户可以结合自己使用场景自定义缓存目录，实现流水线任务多次运行缓存共享。

如果您未设置正确的缓存目录，会导致您每次进行 Java 构建时，即使依赖文件未未更新，也会下载您项目所有的构建依赖。典型现象如下：

• 即使运行多次后，依然需要耗时很久。

  

• 即使运行多次后，依然要下载大量的构建依赖。

  

如果您的场景包括以下任意一种：

• 没有使用企业自定义的settings.xml（代码库根目录 or 企业自定义 Maven 配置）。

• 使用了企业自定义的settings.xml（代码库根目录 or 企业自定义 Maven 配置），但settings.xml中不包含自定义缓存目录节点 <localRepository></localRepository>。

请在 流水线编辑 -> 变量和缓存 中添加 Maven 缓存目录/root/.m2。

提速效果

增加缓存目录的流水线，只会在第一次构建时下载您所需的依赖文件，后续构建会直接从缓存中加载依赖。

项目的依赖文件越多，缓存的加速效果越明显。

Java 构建缓慢—删除缓存文件

由于 Flow 流水线执行时，每个任务节点都会创建新的构建环境，构建完后会销毁，为解决流水线运行过程中，构建依赖反复下载的问题，提升整体构建效率，Flow 提供了自定义缓存功能。用户可以自定义自己的缓存目录，实现流水线任务多次运行的缓存共享。

当您在构建指令中使用rm -rf删除了部分缓存文件，会导致您每次构建过程中都会反复下载依赖文件，从而导致构建缓慢。

如果您是担心依赖的 snapshot 包更新后，流水线无法及时拉取，可以修改您的构建指令如下：

mvn -B clean package -Dmaven.test.skip=true -Dautoconfig.skip -U

在构建指令中添加-U的作用：

• 对于 release 版本，缓存中已经存在，则不会重复下载

• 对于 snapshots 版本，不管缓存中是否存在，都会强制刷新，但是刷新并不意味着把jar重新下载一遍。只下载几个比较小的文件，通过这几个小文件确定本地和远程仓库的版本是否一致，再决定是否下载

Java 构建缓慢—自定义 Maven 配置

当您使用了企业自定义的settings.xml（代码库根目录 or 企业自定义 Maven 配置），且在settings.xml中 <localRepository></localRepository> 自定义了缓存目录。如果您未将该目录添加至 Flow 流水线的缓存目录，则会导致您每次进行 Java 构建时，即使您的依赖文件未发生任何变化，都会下载您项目所有的构建依赖。

您可以通过以下两种方案：

• 删除您企业自定义的settings.xml（代码库根目录 or 企业自定义 Maven 配置）中 <localRepository></localRepository> 节点，使用默认缓存目录，确保 流水线编排 -> 变量与缓存 中添加 Maven 缓存目录/root/.m2。

  重要

  缓存目录填写正确且开关开启。

  

• 将您企业自定义的settings.xml（代码库根目录 or 企业自定义 Maven 配置）中 <localRepository></localRepository> 节点的目录，添加到 流水线编排 -> 变量与缓存 的缓存目录中。请注意：缓存目录填写正确且开关开启。

Java 构建报错 Could not resovle dependencies for project com.xxx

问题描述：Java构建步骤依赖缺失导致构建失败，典型报错如下。

解决方案：请参考Maven依赖设置检查流水线构建使用的settings.xml是否符合预期，检查settings.xml文件中配置的依赖库是否符合预期，检查依赖库中是否存在目标包文件。

Java 构建缓慢—下载海外依赖

当您使用云效 Flow 进行 Java 构建时，Flow 支持通过三种方式设置 settings.xml 完成 Maven 配置：

• 代码库根目录 settings.xml 文件。

• Flow 企业设置 -> Maven 设置中上传 settings.xml 文件。

• 云效默认的 Maven 配置 settings.xml 文件。

其中，第三种方式，云效默认 Maven 配置会帮你自动配置连接阿里云企业私有仓库和阿里云公共代理仓库。

若您通过前两种方式使用了企业自定义的 settings 文件（代码库根目录 or 企业自定义 Maven 配置），且settings.xml中未配置国内的代理仓库，会导致您所有公共的构建依赖都从境外 Maven 中央库进行下载，从而导致构建缓慢。典型现象如下：

加速方案

优化您的企业 settings 文件（代码库根目录 or 企业自定义 Maven 配置），添加阿里云公共代理仓库，如下：

<mirrors>
 <mirror>    
  <id>mirror</id>    
  <mirrorOf>central,jcenter</mirrorOf>
  <name>aliyunmaven</name>
  <url>https://maven.aliyun.com/nexus/content/groups/public</url>
 </mirror>
</mirrors>

提速效果

从阿里云公共代理仓库下载公共依赖，更快更稳定。

Java 构建失败：未拉取到最新依赖包

问题描述：Java构建过程中，未拉取到最新依赖包导致构建失败。

解决方案：

• 若最新依赖包为新版本号，请检查pom文件中是否更新了相应版本号。

• 若最新依赖包为老版本号（对已存在的依赖包进行了相同版本的覆盖），解决方法如下。

  • 若依赖包是snapshot版本，可使用-U参数强制刷新。构建命令参考如下：

    mvn -B clean package -Dmaven.test.skip=true -Dautoconfig.skip -U

  • 若依赖包是release版本，可能原因是老的release依赖包已经被 Flow 缓存，因为版本未发生更新，构建过程中不会重新下载最新依赖包。可参考 缓存设置 清理缓存后重试。

Java 构建下载jar 包卡住

日志中出现jar包下载不继续往下执行。出现这种情况是由于 jar 包下载失败，首先判断使用 maven 源是否为国内镜像源，推荐使用 aliyun 提供的mave镜像仓库 进行依赖下载加速。

Maven 依赖下载报错，提示：上传的包有问题或者找不到

这种情况通常是用户使用二方库依赖导致，排查顺序：首先确认下载依赖使用的私有仓库地址（默认的 settings.xml 文件在 ~/.m2/settings.xml 下），再登录到对应仓库查看该依赖是否存在。

如果依赖存在且使用的是云效提供的私有仓库（repo.rdc.aliyun.com），可以寻求云效答疑帮助。

日志显示：pom.xml 文件不存在

请检查代码是否克隆成功，如果克隆成功，请确认代码库根目录存在 pom.xml 文件。

如何在镜像构建中获取 Java 构建的构建产物

Flow 流水线内每个任务节点之间工作区相互独立，需要将 Java 构建步骤和镜像构建步骤放在同一个任务节点，可选择以下任务。

Gradle 构建报错 ./gradlew: No such file or directory

问题描述：Java构建步骤失败，提示 ./gradlew: No such file or directory，典型报错如下图。

解决方案：Flow 未提供内置Gradle，建议使用GradleWrapper，请检查代码目录下是否存在gradlew 文件，若不存在请上传gradlew文件后重试。

Gradle 构建报错 ./gradlew：Permission denied

问题描述：Java构建步骤失败，提示 ./gradlew：Permission denied，典型报错如下图。

解决方案：该错误原因为gradlew没有执行权限，可以在构建命令中通过chmod +x gradlew修改gradlew权限后重试。详见下图。

Gradle 构建缓慢或超时失败

问题描述：Java构建步骤Gradle构建缓慢或下载依赖超时失败。

解决方案：

• 检查 Gradle Wrapper 是否存在跨境网络等问题，如有，可参考构建环境更换下载源。

• 检查构建日志是否存在跨境下载依赖情况，如有，可以修改 build.gradle 文件，将依赖仓库配置为国内代理。如下示例。

buildscript {
    repositories {
        maven {
            url 'http://maven.aliyun.com/nexus/content/groups/public/'
        }
        maven {
            url 'http://maven.aliyun.com/nexus/content/repositories/jcenter'
        }
    }
}

allprojects {
    repositories {
        maven {
            url 'http://maven.aliyun.com/nexus/content/groups/public/'
        }
        maven {
            url 'http://maven.aliyun.com/nexus/content/repositories/jcenter'
        }
    }
}

PHP 构建报错 requested PHP extension xxx is missing from your system

问题描述：composer install安装失败，提示缺少部分依赖。

解决方案：可以通过类似apt-get install xxx或者yum install xxx 指令安装相关依赖。

PHP 构建 Composer 版本不满足

问题描述：PHP 构建时因 Composer 版本问题导致失败。

解决方案：云效默认 PHP 环境中，提供的 Composer 为 1.8.6。您可通过添加以下指令将默认环境中的 Composer 版本快速升级至 2.1.5。

wget https://rdc-public-software.oss-cn-hangzhou.aliyuncs.com/composer/2.1.5/composer.phar -O /usr/local/bin/composer

GO 构建报错 not found: xxx 无法访问仓库

问题描述：Go构建步骤报错not found xxx，无法访问仓库，典型报错如下。

解决方案：Go 构建过程中，如果需要通过private registry下载依赖文件，需要在环境中配置相关凭证，可参考设置依赖下载访问凭证配置。

GO 构建下载海外依赖导致构建缓慢

问题描述：从 Github等海外仓库直接下载构建依赖会导致构建缓慢。

解决方案：建议添加以下命令，设置国内代理。

export GOPROXY=https://goproxy.cn

GO 构建报错 no rule to make target build

问题描述：使用make build执行 go 构建，报错no rule to make target build...。

解决方案：

• 执行 make build 需要代码仓库下有 makefile 文件，请检查您代码中该文件是否存在。

• 修改流水线中的执行命令，使用本地可以通过的构建命令。

Golang 构建下载依赖卡住

日志中出现依赖下载后不继续执行，可能是由于使用了海外的 go 镜像源。阿里云提供了官方的 Go Module 代理仓库服务，来避免模块拉取缓慢或失败的问题，加速构建。

Go 镜像源访问报错，提示：unrecognized import path

这种情况通常是引文海外 Go 镜像源存在访问不稳定的情况。建议将镜像源改为使用阿里云提供的 Go 镜像源：https://developer.aliyun.com/mirror。

NodeJS 构建下载Npm 包卡住

日志中 npm install 后不继续往下执行，可能是由于使用海外 npm 镜像源，使用 cnpm 替换 npm 可以切换到使用 淘宝 NPM 镜像。

其他依赖，如无法下载tar 包

可以考虑将依赖上传到 开始使用OSS，再生成外部下载链接下载。

其他问题

检查是否在脚本中执行了耗时超过一小时的操作。我们建议一个步骤的功能尽可能简单，如果有耗时过长的步骤导致任务超时，请将其拆分为多个步骤且分别在不同任务中进行。

代码下载报错，提示：Clone Failed

这种情况通常是触发流水线的没有代码的访问权限，或者输入源中配置的分支不存在，请检查相关配置。

npm 构建报错，提示：找不到 module

这种情况通常是没有执行 cnpm install， 请检查相关任务的执行命令中是否有 cnpm install，没有请加上。

构建报错，提示：上传文件路径不存在

请检查本地执行构建的构建产物路径和流水线中配置的产物上传路径是否一致。

上传文件的时候试图使用正则匹配，例如： */target/*.jar

上传文件路径不支持正则匹配，需使用 target/ 或者 target/app.jar 这种格式。