如何在Azure Front Door中匹配请求路径首文件夹并设置请求头？

一、规则引擎配置步骤 #

• 创建新规则：在Azure Front Door规则引擎中新建规则，命名为Set-Header-From-First-Folder（自定义名称即可）
• 添加路径匹配条件：
  • 条件类型选路径，匹配类型选正则表达式，输入正则表达式 ^/([^/]+)/
  • 该正则会精准匹配根目录下的第一个文件夹（如示例中的config、identity），捕获组$1即为目标值
• 添加修改请求头动作：
  • 动作类型选修改请求头，动作选添加，自定义头名称（比如X-First-Folder），头值填写 {{{rule.conditions.0.matchGroups.0}}}
  • 注意必须使用三重大括号，这是Azure Front Door规则引擎引用正则捕获组的语法要求
• 关联到目标路由：确保该规则引擎绑定到对应的路由，路由的路径匹配设置为/*，保证所有目标请求能触发规则

二、常见问题排查 #

• 正则匹配失效：检查正则是否带开头的^/，^/([^/]+)/会严格匹配根目录下的第一个文件夹，避免用/([^/]+)（会匹配路径中任意位置的非斜杠段）
• 捕获组引用错误：必须用{{{rule.conditions.N.matchGroups.M}}}格式，N是条件索引（从0开始），M是捕获组索引（从0开始），两个大括号会被解析为普通文本
• 路由优先级冲突：确保绑定规则的路由优先级高于其他更具体的路由，否则请求会被其他路由拦截，无法触发当前规则
• 动作作用范围验证：规则引擎的修改请求头动作默认作用于后端请求，无需额外配置，若仍不生效可检查规则的触发顺序

三、与Application Gateway的差异说明 #

Application Gateway重写规则用{R:N}引用捕获组，而Azure Front Door采用三重括号的插值语法，这是最容易踩坑的差异点。另外Front Door的规则匹配逻辑更严格，必须通过^锚定开头，确保只匹配根目录下的第一个文件夹

内容的提问来源于stack exchange，提问作者Julian.Net