本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 构建问题排查
<a name="troubleshooting-build-issues"></a>

如果您在创建或构建 Amplify 应用程序时遇到问题，请参阅本节中的相关主题以获取帮助。

**Topics**
+ [向我存储库发出的新提交未触发 Amplify 构建](#commits-not-triggering-builds)
+ [创建新应用程序时，我的存储库名称未在 Amplify 控制台中列出](#repo-not-listed)
+ [我的构建失败了并返回 `Cannot find module aws-exports` 错误（仅限 Gen 1 应用程序）](#cannot-find-aws-exports)
+ [我想覆盖构建超时值](#override-build-timeout)

## 向我存储库发出的新提交未触发 Amplify 构建
<a name="commits-not-triggering-builds"></a>

如果向 Git 存储库发出的新提交没有触发 Amplify 构建，请检查您的 Webhook 是否仍存在于您的存储库中。如果存在，请检查 Webhook 请求的历史记录，看看是否出现任何失败。对于传入的 Webhook，Amplify 的有效载荷大小上限为 256 KB。如果您将提交推送到包含大量已更改文件的存储库，则可能会超过此限制并导致无法触发构建。

## 创建新应用程序时，我的存储库名称未在 Amplify 控制台中列出
<a name="repo-not-listed"></a>

在 Amplify 控制台中创建新应用程序时，您可以在**添加存储库和分支**页面上选择组织的可用存储库。如果目标存储库近期没有更新，则可能不会显示在列表中。如果组织有大量存储库，则可能会发生这种情况。要解决此问题，请先将提交推送到该存储库，然后在控制台中刷新存储库列表。这应会使该存储库显示。

## 我的构建失败了并返回 `Cannot find module aws-exports` 错误（仅限 Gen 1 应用程序）
<a name="cannot-find-aws-exports"></a>

如果您的应用程序在构建过程中找不到 `aws-exports.js` 文件，则会返回以下错误。

```
TS2307: Cannot find module 'aws-exports'
```

在构建后端期间，Amplify 命令行界面（CLI）会生成 `aws-exports.js` 文件。要解决此错误，您必须创建一个 `aws-exports.js` 文件以在构建过程中使用。将以下代码添加到构建规范中以创建该文件：

```
backend:
  phases:
    build:
      commands:
        - "# Execute Amplify CLI with the helper script"
        - amplifyPush --simple
```

有关 Amplify 应用程序构建规范设置的完整示例，请参阅[构建规范的 YAML 语法参考](yml-specification-syntax.md#build-yaml-syntax)。

## 我想覆盖构建超时值
<a name="override-build-timeout"></a>

默认构建超时为 30 分钟。您可以使用 `_BUILD_TIMEOUT` 环境变量来覆盖默认构建超时值。最小构建超时为 5 分钟。最大构建超时值为 120 分钟。

有关在 Amplify 控制台中设置应用程序环境变量的说明，请参阅[设置环境变量](setting-env-vars.md)。