【Azure Container App】使用 yaml 部署 Container App 时遇见 400 Bad Request 错误

问题描述

使用 az containerapp create --yaml <file> 创建 Azure Container App 时， yaml 文件中只包含简单的信息，结果遇见难以理解/无法正常分析的 400 Bad Request问题。

bash 复制代码

location: chinanorth3
properties:
  environmentId: "/subscriptions/<subscription id>/resourceGroups/<resource group name>/providers/Microsoft.App/managedEnvironments/<environment name>"
  configuration:
    ingress:
      external: true
      targetPort: 8080
    registries:
      - server: <ARC Name>.azurecr.cn
        identity: <user identity resource id>"
  template:
    containers:
      - name: myapp
        image: <Image URL:Tags>
        resources:
          cpu: 0.5
          memory: 1Gi

在实际的操作中的错误信息：

bash 复制代码

az : WARNING: The behavior of this command has been altered by the following extension: containerapp
At line:3 char:1
+ az containerapp create   --name my-container-app-0430   --resource-gr ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (WARNING: The be...n: containerapp:String) [], RemoteException
    + FullyQualifiedErrorId : NativeCommandError
 
ERROR: Bad Request({"type":"https://tools.ietf.org/html/rfc9110#section-15.5.1","title":"One or more validation errors occurred.","status":400,"errors":{"$":["The JSON value could not be converted to System.Boolean. Path: $ | LineNumber: 0 | BytePositionInLine: 
4."]},"traceId":"00-*********-********-01"})

错误截图：

基于以上问题，应该如何解决呢？

问题解答

在使用 az containerapp create --yaml <file> 创建 Azure Container App 时，CLI 扩展会将完整的内部模型对象序列化后作为 HTTP PUT 请求体发送给 Azure Resource Manager（ARM）。

该序列化行为存在缺陷：即使 YAML 中未设置的可选字段也会被包含进请求体，并被显式赋值为 null 。

这种行为导致 ARM 在反序列化阶段出现类型转换错误，尤其是当某些字段在后端模型中为非空类型（例如 System.Boolean）时，ARM 尝试将 null 转换为布尔值会直接失败，最终返回 HTTP 400 错误。

通过 --debug 日志可以观察到请求体中包含大量 null 字段。

"allowInsecure": null 这一个字段正是问题的关键，因为 ARM 期望其为布尔类型而非 null，从而导致整体请求失败。

az containerapp create --name <xxxxx> --resource-group <xxxxx> --yaml "containerapp.yaml" --debug

（为 az containerapp create 添加 --debug ，打印出完整的请求日志，就可以发现HTTP请求body中，很多字段默认添加了 null 值）

补充说明：

az containerapp update --yaml 命令可以正常执行，因为它使用的是 HTTP PATCH，仅提交变更字段（不包含 null 字段）。
az deployment group create（Bicep/ARM 模板）也不存在该问题，因为其序列化过程不会注入 null 字段。

解决方案

在ACA的yaml文件中，指定 allowInsecure 的值为false就可以了。

参考资料

$containerapp$ az containerapp create --yaml injects null fields into PUT request body, causing HTTP 400 (System.Boolean conversion error) #9729 ： https://github.com/Azure/azure-cli-extensions/issues/9729

Configure ingress for your app in Azure Container Apps ： https://learn.microsoft.com/en-us/azure/container-apps/ingress-how-to?pivots=azure-cli

Azure Container Apps ARM and YAML template specifications ： https://learn.microsoft.com/en-us/azure/container-apps/azure-resource-manager-api-spec?tabs=yaml

当在复杂的环境中面临问题，格物之道需：浊而静之徐清，安以动之徐生。云中，恰是如此!