如何查看Bicep部署的内部错误详情？含PowerShell及Azure UI疑问

部署场景 #

使用以下PowerShell命令部署Bicep模板：

New-AzResourceGroupDeployment -ResourceGroupName $ResourceGroupName -Mode Incremental -TemplateFile .\appservice_linux.bicep -TemplateParameterObject $templateParameters -Verbose

部署失败后收到报错：

Error: Code=InvalidTemplateDeployment; Message=The template deployment
'appservice_linux' is not valid according to the validation procedure.
The tracking id is '3af29b5f-342a-48fe-8017-6459490c15fd'. See inner
errors for details.

问题与解答 #

1. 如何查看带详情的内部错误？ #

• PowerShell直接查询：
  使用跟踪ID和部署名称获取完整错误信息，展开内部错误详情：

  # 获取部署错误对象
  $deploymentError = (Get-AzResourceGroupDeployment -ResourceGroupName $ResourceGroupName -DeploymentName 'appservice_linux').Error
  # 查看内部错误详情
  $deploymentError.InnerError
  

• 捕获执行时的错误：
  在执行部署命令时添加错误捕获逻辑，直接获取内部错误：

  try {
      New-AzResourceGroupDeployment -ResourceGroupName $ResourceGroupName -Mode Incremental -TemplateFile .\appservice_linux.bicep -TemplateParameterObject $templateParameters -Verbose -ErrorAction Stop
  } catch {
      $_.Exception.InnerException.InnerError
  }
  

2. New-AzResourceGroupDeployment是否有返回内部错误的参数？ #

没有专门用于返回内部错误的独立参数，但可以通过两种方式获取内部错误：

• 执行命令时添加-ErrorAction Stop，将错误转为终止异常，通过捕获异常对象的InnerException.InnerError属性查看详情；
• 不使用-ErrorAction Stop时，命令会返回包含Error属性的结果对象，直接访问该对象的InnerError字段即可获取内部错误详情。

3. Azure UI无部署记录，为何看不到该跟踪ID？ #

主要有以下几种原因：

• 本地验证失败：如果模板存在语法错误、参数不合法等问题，部署请求可能在本地验证阶段就被拦截，根本没有发送到Azure后端，自然不会生成UI部署记录；
• 记录延迟：Azure门户的部署记录可能存在数分钟的同步延迟，可等待一段时间后刷新页面重试；
• 资源组选择错误：确认当前在门户中查看的是命令指定的$ResourceGroupName对应的资源组，避免因选错资源组导致看不到记录；
• 权限不足：登录门户的账号没有该资源组的部署读取权限，可检查账号是否拥有「读者」「参与者」等具备部署记录查看权限的角色。

内容的提问来源于stack exchange，提问作者Don Chambers