針對使用 Azure 藍圖發生的錯誤進行疑難排解
重要
在 2026 年 7 月 11 日，藍圖 (預覽) 將會淘汰。 將現有的藍圖定義和指派移轉至範本規格和部署堆疊。 藍圖成品會轉換成用來定義部署堆疊的 ARM JSON 範本或 Bicep 檔案。 若要了解如何將成品撰寫為 ARM 資源，請參閱：
您可能會在建立、指派或移除藍圖時遇到錯誤。 此文章說明可能發生的各種錯誤與解決方式。
尋找錯誤詳細資料
許多錯誤都是將藍圖指派給某個範圍而產生的結果。 當指派失敗時，藍圖會提供有關失敗部署的詳細資料。 此資訊會指出問題，以便能夠進行修正，而使下一次部署能成功。
在左側窗格中選取 [所有服務]。 搜尋並選取 [藍圖]。
從頁面左邊選取 [指派的藍圖]，然後使用搜尋方塊來篩選藍圖指派，即可尋找失敗的指派項目。 您也可以依 [佈建狀態] 欄排序指派表格，以查看所有已群組在一起的失敗指派。
選取具有 [失敗] 狀態的藍圖，或以滑鼠右鍵按一下並選取 [檢視指派詳細資料]。
代表指派失敗的紅色橫幅警告位於藍圖指派頁面的最上方。 選取該橫幅上的任一處，以取得更多詳細資料。
錯誤通常是由成品 (而非整個藍圖) 造成的。 如果成品建立金鑰保存庫，而且 Azure 原則防止建立金鑰保存庫，則整個指派會失敗。
一般錯誤
案例：違反原則
問題
範本部署因為原則違規而失敗。
原因
原則可能會因下列因素而與部署產生衝突：
- 要建立的資源受到原則所限制 (通常是 SKU 或位置限制)
- 部署正在設定原則所設定的欄位 (通常會使用標記)
解決方法
變更藍圖，使其不會與錯誤詳細資料中的原則發生發生衝突。 如果此變更不可行，替代選項就是變更原則指派的範圍，使藍圖不再與原則產生衝突。
案例：藍圖參數是函式
問題
為函式的藍圖參數會先經過處理，再傳遞至成品。
原因
將使用如 [resourceGroup().tags.myTag] 等函式的藍圖參數傳遞至成品，會造成在成品上設定該函式處理過後的結果，而非動態函式。
解決方法
若要將函式作為參數傳遞，請使用 [ 逸出整個字串，讓藍圖參數看起來像 [[resourceGroup().tags.myTag]。 逸出字元會導致「藍圖」在處理藍圖時，將值視為字串。 接著，藍圖服務會將函式置於成品上，使之依預期成為動態函式。 如需詳細資訊，請參閱 Azure Resource Manager 範本中的語法和運算式。
刪除錯誤
案例：指派刪除逾時
問題
藍圖指派的刪除作業未完成。
原因
刪除時，藍圖指派可能會停滯在非終端機狀態。 當藍圖指派所建立的資源仍在等待刪除，或未將狀態碼傳回 Azure 藍圖時，就會造成此狀態。
解決方法
非終端機狀態的藍圖指派會在六小時逾時後自動標記為 [失敗]。 藍圖指派的狀態經逾時調整後，就可以重試刪除。
下一步
如果您沒有看到您的問題，或無法解決您的問題，請瀏覽下列其中一個管道以取得更多支援：
- 透過 Azure 論壇獲得由 Azure 專家所提供的解答。
- 與 @AzureSupport 連繫 - 此是專為改善客戶體驗而設的官方 Microsoft Azure 帳戶，協助 Azure 社群連接至適當的資源，像是解答、支援及專家等。
- 如果需要更多協助，您可以提出 Azure 支援事件。 請移至 Azure 支援網站，然後選取 [取得支援]。