部署至Azure的网站访问出现权限错误，本地运行正常求解决方案

刚碰到这个问题的时候我也挠头——本地跑起来顺得不行，一部署到Azure就给我整这出，咱们一步步排查解决：

1. 先确认默认文档配置 #

Azure默认只会找index.html、default.aspx这类常规默认页，如果你的应用入口是自定义的（比如start.html或者app.html），不管本地怎么跑，Azure都找不到启动页，直接给你抛权限错误。

• 打开你的web.config，在<system.webServer>节点里添加默认文档配置，比如：

  <defaultDocument>
    <files>
      <add value="你的启动页面文件名" />
    </files>
  </defaultDocument>
  

• 同时去Azure门户，找到你的应用服务→配置→默认文档，把你的启动页加进去，并且拖到最上面（优先级最高）。

2. 检查部署文件完整性与权限 #

有时候部署过程中文件丢了，或者Azure应用服务的身份权限不够，也会触发这个错误：

• 打开Azure门户的高级工具→Kudu→Debug console→CMD，进入site/wwwroot目录，看看本地的文件是不是都传上来了（比如build后的dist文件夹、依赖包之类的）。如果缺文件，重新部署一次，确保部署任务指定了正确的源文件夹。
• 如果是ASP.NET类应用，检查web.config里的authentication节点，有没有误开启了Windows认证但Azure没配置对应的身份源——这种情况下Azure会直接拒绝访问。

3. 单页应用（SPA）的路由坑 #

如果你的应用是React、Vue这类SPA，前端路由是客户端处理的，Azure默认会把不存在的路径当成无效请求，返回权限错误。这时候需要在web.config里加URL重写规则：

<rewrite>
  <rules>
    <rule name="SPA Route" stopProcessing="true">
      <match url=".*" />
      <conditions logicalGrouping="MatchAll">
        <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
        <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
      </conditions>
      <action type="Rewrite" url="/index.html" />
    </rule>
  </rules>
</rewrite>

把上面的index.html换成你的SPA入口页面就行，这样所有非文件/目录的请求都会重定向到入口页，由前端路由处理。

4. 最后试试重启应用服务 #

有时候部署后的缓存会导致配置没生效，去Azure门户的应用服务概述页面，点一下重启按钮，等重启完成后再访问试试。

如果还是不行，去Kudu的日志流里看具体的错误日志，里面会有更详细的权限或路径相关的提示，能帮你更快定位问题。

内容的提问来源于stack exchange，提问作者Curious-programmer