Azure Front Door：如何在‘匹配模式’中使用正则表达式并配置带参路径？

核心逻辑说明 #

Azure Front Door的路由路径匹配仅作用于URL的路径部分（即?之前的内容），查询字符串（?及之后的参数）不属于路径匹配范畴，直接将查询参数写入路由路径会导致配置无效。

正确配置步骤 #

1. 设置基础路径匹配

   • 若仅匹配/login路径（不含子路径），路由路径配置为：/login
   • 若需匹配/login开头的所有子路径，路由路径配置为：/login/*（注意是/*而非*，后者是错误的前缀匹配写法）

2. 添加查询参数匹配条件
   要精准匹配RelayState=%2Ftest这个查询参数，需在路由规则的匹配条件中新增查询字符串规则：

   • 匹配类型选择「等于」（或根据需求选「包含」）
   • 查询参数名填写：RelayState
   • 参数值填写：/test（无需URL编码，Front Door会自动处理编码后的请求匹配）

3. 组合匹配规则
   将路径匹配规则与查询参数匹配规则结合，即可实现对/login?RelayState=%2Ftest请求的精准路由。

常见错误原因解析 #

• 直接配置/login?RelayState=%2Ftest：Front Door将整个字符串视为路径，而路径中不允许包含?字符，因此配置报错。
• 使用/login*：错误的前缀匹配语法，正确的前缀匹配需用/login/*，且该规则仅匹配路径，不包含查询参数。
• 正则表达式尝试匹配?：正则路径匹配同样仅作用于路径部分，无法覆盖查询字符串，因此正则中写?无效。

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