Azure静态网站staticwebapp.config.json未实现路由重定向问题

• 配置文件语法或节点错误：检查staticwebapp.config.json的JSON格式是否合规，比如是否有遗漏的逗号、不匹配的引号。重点确认navigationFallback节点的配置：必须明确设置rewrite为/index.html，同时exclude列表不能包含会匹配所有路径的规则（比如/*），否则会覆盖回退逻辑。正确的导航回退配置示例：

  {
    "navigationFallback": {
      "rewrite": "/index.html",
      "exclude": ["/images/*.{png,jpg,gif}", "/css/*"]
    }
  }
  

• 配置文件未在部署根目录：Azure静态Web应用只会读取部署包根目录的staticwebapp.config.json。如果你的SPA构建工具（如React、Vue）将产物输出到build或dist目录，要确保配置文件被复制到该输出目录的根目录，而非源码根目录。部署时检查构建 artifact 的结构，确认配置文件位置正确。

• 自定义路由规则冲突：若配置了routes节点，需检查规则优先级和匹配逻辑。如果某条路由规则先匹配了未知路径并返回404，或者规则顺序导致navigationFallback未触发，就会出现问题。确保navigationFallback是兜底规则，没有被其他自定义规则覆盖。

• 缓存导致配置未生效：浏览器本地缓存或Azure CDN缓存可能保留了旧的配置或404响应。尝试用隐私窗口访问目标URL，或手动清空浏览器缓存；也可以在Azure门户重新触发部署，强制刷新配置。

• 环境或函数路由冲突：如果使用了预览环境，确认配置已同步到生产环境；若部署了函数API，检查函数路由是否与SPA路由重叠，函数路由的优先级高于SPA回退规则，可能导致未知路径被函数拦截返回404。

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