Azure FrontDoor对接存储静态网站时遇comp参数无效错误求助

错误原因 #

这个错误是因为FrontDoor默认将请求转发到了存储账户的Blob API端点，而非静态网站的专用Web端点，导致存储识别到无效的comp查询参数（Blob API需要该参数，但静态网站端点不需要）。

具体解决步骤 #

方案一：自定义主机类型后端配置 #

• 后端池设置：
  • 后端主机类型选择自定义主机，主机名填写静态网站完整端点：myappjohndev1.z11.web.core.windows.net
  • 后端端口：HTTPS填443，HTTP填80（推荐用HTTPS）
  • 强制设置后端主机头为myappjohndev1.z11.web.core.windows.net（这是核心，默认主机头会使用FrontDoor域名，导致存储误判为Blob请求）
• 路由规则配置：
  • 路径匹配设为/*，覆盖所有SPA路由
  • 转发协议选择HTTPS only
  • 开启URL重写，设置重写路径为/{R:1}，确保请求路径正确转发到静态网站

方案二：存储账户类型后端配置 #

• 后端池设置：
  • 后端主机类型选择存储，选中托管SPA的存储账户
  • 手动指定目标资源路径为/$web（静态网站文件所在的容器）
  • 同样设置后端主机头为myappjohndev1.z11.web.core.windows.net
• 路由规则配置同方案一，路径匹配/*，转发协议HTTPS only

SPA路由适配（必做） #

React SPA刷新非根路径（如/about）会触发404，需额外配置：

• 方法1：在存储账户静态网站设置中，将404文档路径设为/index.html，存储会自动把404请求转发到SPA入口文件
• 方法2：在FrontDoor路由规则中添加错误路由，当后端返回404状态码时，重定向到/index.html

验证 #

配置完成后等待5-10分钟让FrontDoor生效，访问https://devjohn1.azurefd.net测试：

• 根路径是否正常加载SPA
• 刷新非根路径是否能正常跳转

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