Azure Static Web Apps自定义角色分配函数未生效问题

没有近期的破坏性功能变更，问题基本都是配置或部署细节踩坑，按以下点逐一核对即可：

• 首先核对角色API的授权级别
  你配置的rolesSource指向/api/GetRoles，SWA鉴权层调用该接口时不会携带任何函数密钥，必须保证该Azure Function的authLevel配置为anonymous。如果是默认的function/admin级别，接口调用会直接返回401，鉴权层拿不到角色响应就会静默跳过自定义角色赋值，用户登录流程完全正常但始终拿不到自定义角色，且不会有显性报错。
• 核对角色API的可访问性与响应格式
  1. 你贴的代码中引入了node-fetch但未实际使用，先确认部署时依赖安装完整，函数启动无运行时错误，接口调用返回状态码必须为200，且携带Content-Type: application/json响应头，只要接口返回5xx/4xx/3xx状态码，鉴权层都会直接忽略响应内容。
  2. 函数名、路由路径严格大小写敏感，必须保证函数名、部署后的路由路径和配置里写的/api/GetRoles完全一致，大小写偏差会导致接口404。
• 核对配置文件部署位置与有效性
  staticwebapp.config.json必须放在前端构建产物的根目录，而非项目源码根目录。比如前端构建输出到dist文件夹，配置文件必须直接位于dist/staticwebapp.config.json路径下，构建时如果没有把该文件拷贝到输出目录，SWA不会读取到你配置的rolesSource规则。同时检查配置文件没有JSON语法错误（比如多余的尾逗号），语法错误会导致SWA直接忽略整个配置文件内容。
• 清除旧鉴权凭证缓存
  SWA的登录角色信息会加密存在站点cookie中，修改配置或角色代码后，必须先访问/.auth/logout清除现有鉴权cookie，再用无痕窗口重新登录测试，旧cookie未过期时不会重新触发角色拉取逻辑，哪怕后端配置已经修正也不会生效。

快速验证方法 #

完成以上检查后，登录账号直接访问https://<你的站点域名>/.auth/me，查看返回的clientPrincipal对象中的roles数组：

• 如果数组中包含superuser，但访问/secured/*路径仍被拦截，说明路由规则匹配有误，检查构建产物中secured目录的实际路径，确认没有其他路由规则优先级更高覆盖了现有配置。
• 如果数组中没有superuser，直接去SWA的应用日志中筛选GetRoles接口的请求记录，看接口实际返回的状态码和响应内容，定位接口调用失败的原因即可。

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