在项目开发完成后，构建和发布上线通常会使用Jenkins构建工具。然而，在使用Jenkins工具构建项目时，也会遇到一些构建错误问题。通常情况下，如果项目在本地打包时没有问题，启动服务时也没有问题，那么可能是Jenkins配置问题。这时需要开发人员配合修改本地配置项以完成修复。下面我将分享一下我遇到的一些构建失败问题，注意：本文主要讲述的是前端项目的构建失败问题。

一、开发环境

Umi自动化工程创建的React项目。

二、构建失败现象

从上图可以看出，构建过程中出现打包命令错误，使用了无法识别的`npm run build:prod`命令。该命令是在前端工程项目的`package.json`包文件中的`scripts`部分配置的。在这个案例中，前端并没有配置`build:prod`这个打包命令。

从下图可以看出，前端项目中缺少了构建所需的配置项。

三、构建失败原因

通过以上分析，我们可以得出结论：构建时报错是因为打包命令出错，而这是由于前端项目缺少了`build:prod`这个打包命令导致的。实际上，这是在前端项目的`package.json`文件中的`scripts`部分配置的。但在本案例中，前端并没有配置这个命令。

四、解决办法

针对这个问题，我们有两种解决方法：

1. 方法一：直接在Jenkins上将打包命令配置成前端包文件中配置的命令。由于本案例中没有区分不同的开发环境，并且项目只有一个主分支(master),因此可以直接将Jenkins里的打包命令配置为`npm run build`(如上图所示)。进入Jenkins工具，找到对应的配置项进行设置。

2. 方法二：如果项目变得复杂，需要进行严格的环境区分，那么建议使用第二种方法：使用环境变量区分不同环境的打包命令。具体操作步骤如下：

a. 在前端项目的根目录下的`package.json`文件中，打开并在`scripts`部分配置`build:prod`的打包命令(如上图所示)。

b. 在前端项目的配置文件`config.js`中配置`APP_ENV`环境变量来区分不同的环境，例如生产环境、开发环境、测试环境等。以下是一个示例配置：

```javascript

module.exports = {

// ...其他配置项

env: {

APP_ENV: process.env.NODE_ENV || 'development', // 默认为开发环境

},

};

```

总结：本文主要讨论了Jenkins构建失败的现象以及导致失败的原因，并提供了两种解决方法。后续我们将继续补充其他可能遇到的失败情况，或者大家可以在评论区回复自己遇到的失败情况。欢迎留言讨论！