Azure部署报错：tenantId为null无效，如何定位对应资源？

我执行命令az deployment sub what-if --location uksouth --template-file .\main.bicep --verbose测试部署时，收到以下无效模板部署错误：

InvalidTemplateDeployment - 模板部署'main'不符合验证流程，跟踪ID为'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx'。详见内部错误。
BadRequest - 提供的resource.properties.tenantId 'null'无效。

无法确定该错误指向哪个资源，添加--debug参数运行时还触发Azure CLI异常：

...
处理上述异常期间，发生另一个异常：

Traceback (most recent call last):
  File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/arm.py", line 109, in handle_template_based_exception
AttributeError: 'InvalidTemplateError' object has no attribute 'inner_exception'
...

定位报错资源的方法 #

• 排查模板中涉及tenantId的资源：在Bicep模板中全局搜索tenantId字段，重点检查以下几类资源：

  • 托管标识、服务主体相关资源（如Microsoft.ManagedIdentity/userAssignedIdentities、Microsoft.Authorization/roleAssignments）
  • 租户级权限相关资源（如Microsoft.PolicyInsights/remediations）
  • 自定义资源或扩展资源中引用tenantId的部分
    确认这些资源的tenantId是否被错误设置为null，或是依赖了未初始化的变量/参数。

• 拆分模板逐步验证：将大模板拆分为多个小模块，逐个执行az deployment sub what-if测试，定位到触发错误的模块后，再深入排查其中的资源定义。

• 用Bicep CLI编译诊断：执行bicep build --diagnostics .\main.bicep命令，查看编译阶段的诊断输出，可能直接指出未正确赋值的tenantId字段位置。

• 检查参数与变量：核对所有和tenantId相关的参数、变量，确认是否存在默认值为null，或是错误引用了未定义的变量（正确获取租户ID应使用subscription().tenantId函数）。

• 查看Azure活动日志：登录Azure门户，进入对应订阅的活动日志，搜索报错中的跟踪ID，展开日志详情后可能会显示具体的资源名称或类型。

内容的提问来源于stack exchange，提问作者Greg B