Azure Front Door标准版健康探测路径含特殊字符报错求助

问题详情 #

经典版Azure Front Door中，健康探测路径设为/api/status?code=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx可正常运行，但升级至Standard版后，针对同一Function App后端，门户会弹出不准确的提示“探测路径必须以/开头”——实际是路径中的?和=等查询参数符号不被当前门户输入框的验证逻辑兼容。

可行解决方法 #

• 拆分路径与查询参数：在健康探测配置页，将路径单独设为/api/status，然后到「自定义查询参数」区域添加：

  • 参数名：code
  • 参数值：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    这样既符合门户的输入规则，也能实现带验证参数的健康探测。

• 通过ARM模板配置：如果需要直接保留完整路径，可编写ARM模板部署或更新健康探测，示例配置片段如下：

"healthProbeSettings": {
  "properties": {
    "path": "/api/status?code=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "protocol": "Https",
    "intervalInSeconds": 30,
    "numberOfProbes": 2,
    "healthProbeMethod": "Get"
  }
}

部署该模板可绕过门户的输入限制，直接生效带查询参数的探测路径。

• 使用Azure CLI命令：执行以下CLI命令更新健康探测（替换占位符为你的实际资源信息）：

az afd health-probe update \
  --resource-group <你的资源组名称> \
  --profile-name <你的AFD配置文件名称> \
  --health-probe-name <健康探测名称> \
  --path "/api/status?code=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

补充说明 #

Standard版Azure Front Door的门户界面验证逻辑和经典版不同，它把查询参数判定为路径非法字符，所以给出了错误的提示。但实际上通过ARM模板或CLI可以直接配置带查询参数的路径，拆分参数配置也能达成相同的探测效果。

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