Azure CDN（经典版）规则引擎‘保留未匹配路径’不生效问题咨询

问题根源 #

路径被丢弃且跳转到后端主页，核心是规则的匹配模式、路径变量配置或优先级设置不符合Microsoft CDN经典版的规则逻辑。

具体修复步骤 #

• 修正匹配路径模式：将规则的匹配路径设为/api/*（必须带*通配符），匹配类型选「通配符匹配」，确保能覆盖/api下所有子路径。
• 配置目标路径变量：不要直接填后端根地址，而是把目标路径设为/{unmatchedpath}。这个内置变量会自动提取/api/*中*对应的部分（比如resources/my-resource），拼接到后端API地址后，生成正确的目标URL。
• 确认保留路径开关位置：在你选中的后端API源站配置里，确保Preserve unmatched path设置为Yes——这个开关属于源站配置项，不是匹配条件的一部分。
• 调整规则优先级：把这条API路由规则的优先级设为最高（比如优先级值设为1），避免被其他SPA路由规则抢先匹配。
• 清理缓存后测试：规则生效需要几分钟，手动清除CDN端点缓存，用无痕浏览器测试/api/resources/my-resource路径，避免旧缓存干扰。

标准配置示例 #

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