你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
排查使用 Azure 蓝图时出现的错误
重要
2026 年 7 月 11 日，蓝图（预览版）将弃用。 将现有蓝图定义和分配迁移到模板规格和部署堆栈。 蓝图项目将转换为 ARM JSON 模板或用于定义部署堆栈的 Bicep 文件。 若要了解如何将项目创作为 ARM 资源，请参阅：
创建、分配或删除蓝图时可能会出现问题。 本文描述可能会发生的各种错误及其解决方法。
查找错误详细信息
将蓝图分配到作用域是许多错误产生的原因。 分配失败时，蓝图会提供失败部署的详细信息。 此信息会指出存在的问题，以便可以修复问题并确保后续部署成功进行。
在左侧窗格中，选择“所有服务”。 搜索并选择“蓝图”。
选择左侧页面上的“已分配蓝图”，然后使用搜索框筛选分配的蓝图以找到失败的分配项。 还可以按“预配状态”列对分配表进行排序，集中查看失败的分配项。
选择状态为“失败”的蓝图，或者右键单击然后选择“查看分配详细信息”。
蓝图分配页面顶部有一个红色横幅警告，指出此分配已失败。 选择横幅任意位置可获取更多详细信息。
错误通常是由某个项目导致的，而不是由蓝图整体导致的。 如果某个项目创建密钥保管库但是 Azure Policy 阻止密钥保管库创建，则整个分配将失败。
常规错误
场景：策略冲突
问题
由于策略冲突而导致模板部署失败。
原因
下列原因可能会导致策略与部署相冲突：
- 正在创建的资源受到策略的限制（通常为 SKU 或位置限制）
- 部署是由策略配置的设置字段（通常带有标记）
解决方法
更改蓝图，使其不与错误详细信息中的策略冲突。 如果无法进行此更改，替代方法是更改策略分配的作用域，以使蓝图不再与策略冲突。
方案：蓝图参数是一个函数
问题
作为函数的蓝图参数在传递到项目之前处理。
原因
将使用函数的蓝图参数（例如 [resourceGroup().tags.myTag]）传递到项目会导致在项目上设置的函数的处理结果而不是动态函数。
解决方法
若要将函数作为参数传递，请使用 [ 转义整个字符串，使蓝图参数如 [[resourceGroup().tags.myTag]。 转义字符会导致蓝图在处理蓝图时将值视为字符串。 然后，蓝图服务将该函数放置在项目中，使其按预期动态化。 有关详细信息，请参阅 Azure 资源管理器模板中的语法和表达式。
删除错误
方案：删除分配超时
问题
未完成蓝图分配删除。
原因
删除蓝图分配时，其可能停滞为非终端状态。 如果蓝图分配创建的资源仍在等待删除，或者未向 Azure 蓝图返回状态代码，则会出现此状态。
解决方法
对于非终端状态的蓝图分配，将在“六小时”超时后自动将其标记为“失败”。 因超时而调整了蓝图分配的状态后，可以重试删除。
后续步骤
如果你的问题未在本文中列出，或者无法解决问题，请访问以下渠道之一获取更多支持：
- 请通过 Azure 论坛获取 Azure 专家的解答。
- 连接到 @AzureSupport – Microsoft Azure 官方帐户，它可以将 Azure 社区引导至适当的资源来改进客户体验：提供解答、支持和专业化服务。
- 如需更多帮助，可以提交 Azure 支持事件。 请转到 Azure 支持站点并选择 获取支持。