移除Azure Static Web App内置API后网站出现403错误求助

• 检查静态Web Apps与自定义函数应用的关联状态
  确认静态Web Apps的API设置中已正确关联你的C#函数应用，关联失效可能导致路由规则异常触发403。可在Azure门户的静态Web Apps管理界面，进入API选项卡，重新选择目标C#函数应用并保存配置。

• 验证静态资源与路由配置

  • 查看GitHub Actions部署日志，确认是否存在静态资源权限、路由规则相关警告。
  • 确保项目根目录的staticwebapp.config.json配置了正确的导航回退规则，适配Nuxt3单页应用需求：

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

• 排查C#函数应用的运行状态与权限

  • 进入函数应用的「监测」->「日志流」查看基础运行日志（免费额度内无额外费用），确认函数应用是否正常启动，无报错。
  • 在函数应用的「访问控制(IAM)」中，添加静态Web Apps的托管标识为「函数应用参与者」角色，确保静态Web Apps有权访问函数资源。

• 检查资源回收与配置

  • 若C#函数应用长时间无请求，可能被系统回收，导致路由转发失败。手动触发一次函数请求，观察网站是否恢复访问。
  • 在函数应用的「配置」->「常规设置」中开启「始终开启」选项，避免资源被自动回收。

• 确认部署配置的有效性

  • 检查GitHub Actions workflow文件中api_location是否确实设置为空字符串，无配置覆盖情况：

    - name: Build And Deploy
      id: builddeploy
      uses: Azure/static-web-apps-deploy@v1
      with:
        azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}
        repo_token: ${{ secrets.GITHUB_TOKEN }}
        action: "upload"
        app_location: "/"
        api_location: ""
        output_location: ".output/public"
    

  • 在静态Web Apps的「部署历史」中查看最新部署的配置详情，确认api_location参数已生效。

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