Power Automate自定义连接器Webhook触发器动态schema配置报错如何解决

你遇到的报错是Power Automate对OpenAPI扩展字段的静态校验逻辑冲突导致的，核心问题有3个：

1. 扩展属性配置重复：你为body/data字段同时配置了x-ms-dynamic-schema和x-ms-dynamic-properties两个微软专属扩展属性，二者作用重叠，导致静态校验阶段无法正确识别字段类型，默认将其解析为无有效枚举值的枚举类型，因此你输入的自定义属性会触发“不在枚举范围内”的校验错误。
2. 缺失开放属性声明：你没有为data对象显式声明additionalProperties: true，静态校验时会要求对象的所有属性都必须在静态定义的schema中，而动态返回的schema在静态校验阶段不会生效，直接触发校验失败。
3. 参数引用规则错误：你在x-ms-dynamic-properties的参数配置中使用了parameterReference关键字，该关键字仅用于跨操作的参数引用，同操作内的路径参数直接用parameter关键字引用即可，用法错误会导致动态属性加载异常。

只需要修改注册接口body中data字段的配置即可，修改后代码如下：

// 仅展示body.schema部分的修改，其余代码保持不变
"schema": {
  "type": "object",
  "properties": {
    "webhookUrl": {
      "type": "string",
      "x-ms-notification-url": true,
      "x-ms-visibility": "internal"
    },
    "data": {
      "type": "object",
      // 二选一保留需要的扩展，这里保留动态属性供用户配置
      "x-ms-dynamic-properties": {
        "operationId": "GetSchema",
        "parameters": {
          "entityType": {
            "parameter": "entityType"
          }
        }
      },
      // 显式声明支持额外属性，绕开静态校验
      "additionalProperties": true
    }
  },
  "required": [
    "webhookUrl"
  ],
  "x-ms-visibility": "important"
}

如果需要同时定义触发推送时的data结构，把动态schema配置放在顶层的x-ms-notification-content中即可，不要在注册接口的body里重复配置。

• 注册请求的body中，标记了x-ms-notification-url的webhookUrl字段必须设为x-ms-visibility: internal，由Power Automate自动填充，不需要用户手动输入，避免配置错误。
• 动态属性和动态schema不要同时配置在同一个字段上：如果是需要用户在配置触发器时输入自定义过滤/参数，仅保留x-ms-dynamic-properties；如果是定义触发后推送数据的结构，仅在x-ms-notification-content中配置x-ms-dynamic-schema。
• 所有承载动态属性的object类型字段，必须显式声明additionalProperties: true，绕开Power Automate的静态schema校验。
• 动态扩展的参数引用统一规则：同操作内的参数用parameter关键字引用，跨操作传递参数才使用parameterReference。

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