Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 對來源儲存庫的問題進行故障診斷
<a name="troubleshooting-source"></a>

以下資訊可協助您疑難排解 CodeCatalyst 中來源儲存庫的常見問題。

**Topics**
+ [我已達到空間的儲存空間上限，並看到警告或錯誤](#source-troubleshoot-storage)
+ [嘗試複製或推送至 Amazon CodeCatalyst 來源儲存庫時發生錯誤](#source-troubleshoot-clone)
+ [我在嘗試遞交或推送至 Amazon CodeCatalyst 來源儲存庫時收到錯誤](#source-troubleshoot-commit-code)
+ [我的專案需要來源儲存庫](#source-troubleshoot-need-repository)
+ [我的來源儲存庫是全新的，但包含遞交](#source-troubleshoot-initial-commit)
+ [我想要不同的分支作為我的預設分支](#source-troubleshoot-default-branch)
+ [我收到有關提取請求中活動的電子郵件](#source-troubleshoot-repository-emails)
+ [我忘記我的個人存取字符 (PAT)](#source-troubleshoot-forgot-pat)
+ [提取請求不會顯示我預期的變更](#source-troubleshoot-pull-request-diff)
+ [提取請求顯示不可合併的狀態](#source-troubleshoot-pull-request-not-mergeable)

## 我已達到空間的儲存空間上限，並看到警告或錯誤
<a name="source-troubleshoot-storage"></a>

**問題：**我想要將程式碼遞交至 CodeCatalyst 中的一或多個來源儲存庫，但我看到錯誤。在 主控台中，我在來源儲存庫頁面上看到一則訊息，指出我已達到空間的儲存限制。

**可能的修正：**視您在專案或空間中的角色而定，您可以縮減一或多個來源儲存庫的大小、刪除未使用的來源儲存庫，或將帳單層變更為具有更多儲存空間的儲存庫。
+ 若要減少專案中來源儲存庫的大小，您可以刪除未使用的分支。如需詳細資訊，請參閱[刪除分支](source-branches-delete.md)及[貢獻者角色](ipa-role-types.md#ipa-role-contributor)。
+ 若要減少空間的整體儲存體，您可以刪除未使用的來源儲存庫。如需詳細資訊，請參閱[刪除來源儲存庫](source-repositories-delete.md)及[專案管理員角色](ipa-role-types.md#ipa-role-project-admin)。
+ 若要增加您空間的可用儲存空間，您可以將帳單方案變更為具有更多儲存空間的方案。如需詳細資訊，請參閱《Amazon [ CodeCatalyst 管理員指南》中的變更 CodeCatalyst 帳單層](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-change-plan.html)。 CodeCatalyst 

## 嘗試複製或推送至 Amazon CodeCatalyst 來源儲存庫時發生錯誤
<a name="source-troubleshoot-clone"></a>

**問題：**當我嘗試將來源儲存庫複製到本機電腦或整合開發環境 (IDE) 時，會收到許可錯誤。

**可能的修正：**您可能沒有 AWS 建置器 ID 的個人存取字符 (PAT)，您可能尚未使用 PAT 設定登入資料管理系統，或者您的 PAT 可能已過期。嘗試下列一或多個解決方案：
+ 建立個人存取字符 (PAT)。如需詳細資訊，請參閱[使用個人存取權杖授予使用者儲存庫存取權](ipa-tokens-keys.md)。
+ 請確定您已接受包含來源儲存庫的專案邀請，而且您仍然是該專案的成員。如果您不是該專案的作用中成員，則無法複製來源儲存庫。登入 主控台，並嘗試導覽至您嘗試複製來源儲存庫的空間和專案。如果您在空間的專案清單中看不到專案，您可能不是該專案的成員，或者您尚未接受該專案的邀請。如需詳細資訊，請參閱[接受邀請並建立 AWS 建置器 ID](sign-up-sign-in.md)。
+ 請確定您的複製命令格式正確，並包含您的 AWS 建置器 ID。例如：

  ```
  https://LiJuan@git.us-west-2.codecatalyst.aws/v1/ExampleCorp/MyExampleProject/MyExampleRepo
  ```
+ 使用 AWS CLI 來確定您的 PAT 與您的 AWS 建置器 ID 相關聯，而且尚未過期。如果您沒有 或 PAT 已過期，請建立一個。如需詳細資訊，請參閱[使用個人存取權杖授予使用者儲存庫存取權](ipa-tokens-keys.md)。
+ 嘗試建立開發環境以使用來源儲存庫中的程式碼，而不是將其複製到本機儲存庫或 IDE。如需詳細資訊，請參閱[建立開發環境](devenvironment-create.md)。

## 我在嘗試遞交或推送至 Amazon CodeCatalyst 來源儲存庫時收到錯誤
<a name="source-troubleshoot-commit-code"></a>

**問題：**當我嘗試推送到來源儲存庫時，會收到許可錯誤。

**可能的修正：**您可能在專案中沒有角色，可讓您遞交程式碼變更並推送至專案。檢視您嘗試將變更推送至來源儲存庫的專案中的角色。如需詳細資訊，請參閱[取得成員及其專案角色的清單](projects-members.md#projects-members-view)及[使用使用者角色授予存取權](ipa-roles.md)。

如果您有允許遞交和推送變更的角色，則您嘗試遞交變更的分支可能會設定分支規則，以防止您推送程式碼變更至該分支。請嘗試建立分支，並將程式碼推送至該分支。如需詳細資訊，請參閱[使用分支規則管理分支的允許動作](source-branches-branch-rules.md)。

## 我的專案需要來源儲存庫
<a name="source-troubleshoot-need-repository"></a>

**問題：**我的專案沒有來源儲存庫，或我的專案需要另一個來源儲存庫。

**可能的修正：**某些專案建立時沒有任何資源。如果您是專案的成員，您可以在 CodeCatalyst 中為該專案建立來源儲存庫。如果具有 **Space 管理員**角色的人員安裝 **GitHub 儲存庫**並將其連接到 GitHub 帳戶，您可以連結到可用的 GitHub 儲存庫，如果您有專案**管理員**角色，則可以將這些儲存庫新增至您的專案。如需詳細資訊，請參閱[建立來源儲存庫](source-repositories-create.md)和[連結來源儲存庫](source-repositories-link.md)。

## 我的來源儲存庫是全新的，但包含遞交
<a name="source-troubleshoot-initial-commit"></a>

**問題：**我剛建立來源儲存庫。它應該是空的，但其中包含遞交、分支和`README.md`檔案。

**可能的修正：**這是預期的行為。CodeCatalyst 中的所有來源儲存庫都包含初始遞交，將預設分支設定為 `main`，並包含範本程式碼 （如果儲存庫是使用包含範本程式碼的藍圖為專案建立） 或儲存庫 README 檔案的範本 Markdown 檔案。您可以在 主控台和 Git 用戶端中建立其他分支。您可以在 主控台中建立和編輯檔案，並在開發環境和 Git 用戶端中刪除檔案。

## 我想要不同的分支作為我的預設分支
<a name="source-troubleshoot-default-branch"></a>

**問題：**我的來源儲存庫隨附名為 的預設分支`main`，但我想要不同的分支作為我的預設分支。

**可能的修正：**您無法變更或刪除 CodeCatalyst 中來源儲存庫中的預設分支。您可以建立其他分支，並在工作流程的來源動作中使用這些分支。您也可以選擇連結 GitHub 儲存庫，並將其用作專案的儲存庫。

## 我收到有關提取請求中活動的電子郵件
<a name="source-troubleshoot-repository-emails"></a>

**問題：**我沒有註冊或設定有關提取請求活動的電子郵件通知，但我仍然會收到它們。

**可能的修正：**有關提取請求活動的電子郵件通知會自動傳送。如需詳細資訊，請參閱[在 Amazon CodeCatalyst 中使用提取請求檢閱程式碼](source-pull-requests.md)。

## 我忘記我的個人存取字符 (PAT)
<a name="source-troubleshoot-forgot-pat"></a>

**問題：**我一直使用 PAT 複製、推送和提取來源儲存庫的程式碼，但我遺失了字符的值，而且在 CodeCatalyst 主控台中找不到它。

**可能的修正：**解決此問題的最快速方法是建立另一個 PAT，並將您的登入資料管理員或 IDE 設定為使用此新的 PAT。我們只會在您建立 PAT 時顯示其值。如果您遺失此值，則無法擷取。如需詳細資訊，請參閱[使用個人存取權杖授予使用者儲存庫存取權](ipa-tokens-keys.md)。

## 提取請求不會顯示我預期的變更
<a name="source-troubleshoot-pull-request-diff"></a>

**問題：**我已建立提取請求，但我看不到預期在來源和目的地分支之間看到的變更。

**可能的修正：**這可能是由許多問題引起的。嘗試下列一或多個解決方案：
+ 您可能正在檢閱較舊修訂版之間的變更，也可能未檢視最新的變更。重新整理瀏覽器，並確定您已選擇要檢視之修訂之間的比較。
+ 並非所有提取請求中的變更都會顯示在主控台中。例如，您無法在主控台中檢視 Git 子模組，因此您無法在提取請求中檢視子模組的差異。有些差異可能太大而無法顯示。如需詳細資訊，請參閱[CodeCatalyst 中來源儲存庫的配額](source-quotas.md)及[檢視檔案檢視檔案變更的歷史記錄](source-files-view.md)。
+ 提取請求會顯示合併基礎與您選擇的任何修訂之間的差異。當您建立提取請求時，所顯示的差異是來源分支的尖端與目的地分支的尖端之間的差異。建立提取請求後，顯示的差別在於修訂及其合併基礎。合併基礎是建立修訂時，目的地分支頂端的遞交。合併基礎可能會在修訂之間變更。如需 Git 中差異和合併基礎的詳細資訊，請參閱 Git 文件中的 [git-merge-base](https://git-scm.com/docs/git-merge-base)。

## 提取請求顯示不可合併的狀態
<a name="source-troubleshoot-pull-request-not-mergeable"></a>

**問題：**我想要合併提取請求，但其狀態顯示為**不可合併**。

**可能的修正：**這可能是由一或多個問題造成：
+ 提取請求的所有必要檢閱者必須先核准提取請求，才能合併。檢閱名稱旁具有時鐘圖示的任何檢閱者所需的檢閱者清單。時鐘圖示表示檢閱者尚未核准提取請求。
**注意**  
如果在核准提取請求之前，已從您的專案中移除必要的檢閱者，則無法合併提取請求。關閉提取請求並建立新的提取請求。
+ 來源分支和目的地分支之間可能存在合併衝突。CodeCatalyst 不支援所有可能的 Git 合併策略和選項。您可以評估分支在開發環境中的合併衝突，或複製儲存庫，並使用 IDE 或 Git 工具來尋找和解決合併衝突。如需詳細資訊，請參閱[合併提取請求](pull-requests-merge.md)。