单页应用(SPA)接入Azure AD时修改地址栏URL持续报错如何解决

你遇到的报错是单页应用（SPA）客户端路由与服务端路由规则不匹配的典型表现，接入Azure AD的场景下通常由两类原因触发：

• SPA默认采用前端路由管理页面跳转，仅首次加载时会请求服务端的index.html入口文件，后续页面跳转都在浏览器端完成。手动修改地址栏URL相当于直接向服务端发起该路径的资源请求，服务端无对应路径的静态资源就会返回404类错误，对应你看到的提示：

您查找的资源已被移除、名称已更改或暂时不可用。

• 接入Azure AD后启用了全局路由授权拦截，服务端/CDN未对SPA路由规则做特殊适配，导致路由跳转前的授权校验逻辑被拦截，也会触发该报错。

按优先级从高到低验证：

• 先切换路由模式测试：将SPA路由从History模式临时改为哈希模式（路径带#标识），如果修改后手动修改URL不再报错，可直接定位为History路由的服务端适配问题。
• 解耦Azure AD逻辑验证：临时关闭Azure AD的全局路由拦截，手动修改URL测试是否还报错，如果关闭后恢复正常，说明是Azure AD的路径白名单配置问题。
• 检查静态托管服务配置：确认你所用的Nginx/CDN/Azure静态托管服务是否配置了「所有请求 fallback 到index.html」的规则。

History路由适配方案 #

根据你使用的托管服务选择对应配置：

• Nginx托管：在server配置块中添加如下规则：

location / {
  try_files $uri $uri/ /index.html;
}

• Azure Blob Storage静态网站托管：在静态网站配置页的「错误文档路径」字段填入/index.html，将所有404请求重定向到SPA入口文件。
• Azure Static Web Apps托管：在项目根目录新增staticwebapp.config.json文件，添加如下配置：

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

Azure AD配置适配 #

• 进入Azure AD应用注册管理页，在「重定向URI」配置中添加你所有用到的SPA前端路径到白名单，避免授权回调时被拦截。
• 如果你使用MSAL.js库接入Azure AD，确认msalConfig配置项中的redirectUri和你实际的访问域名、路径完全匹配，同时开启navigateToLoginRequestUrl参数，保证登录完成后可正常跳转回用户手动输入的目标路径。

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