如何调试「You do not have permission to view this directory or page」错误及排查Azure发布问题

兄弟，我之前部署ASP.NET Core到Azure时也踩过这个坑，给你整理几个实用的排查步骤，一步步来应该能搞定：

• 确认默认文档设置：Azure App Service经常会因为找不到启动页面抛出这个错误。登录Azure Portal找到你的应用服务，进入「配置」->「默认文档」，看看列表里有没有你的项目入口（比如index.html、ASP.NET Core的启动路径对应的页面），要是没有就手动加进去——尤其是单页应用或者自定义了启动页的情况，这个是最常见的原因。
• 检查HTTPS强制设置：如果你的应用开了「HTTPS 仅」，但你访问的是HTTP地址，也会跳转到这个权限错误页。去「配置」->「常规设置」里看看这个选项是不是开启了，要是开了就确保访问的是https://开头的URL。
• 验证应用服务计划权限：虽然默认配置一般没问题，但如果是用了部署槽或者特殊网络配置，还是去「访问控制(IAM)」里看看服务主体的角色分配，至少要有网站内容的读取权限。

• 本地先测发布包：在Visual Studio重新生成发布包（右键项目→发布→生成包），然后本地用dotnet run或者IIS Express跑一下这个发布后的文件，如果本地也报错，那就是代码或者配置在发布环节出问题了——比如依赖项没打包进去、appsettings.json里的连接字符串写错了。
• 对比前后代码变更：既然之前运行正常，这次出问题，用Git对比两次提交的差异，重点盯这几个文件：
  • Program.cs（或者旧版本的Startup.cs）：有没有改路由配置、中间件顺序？比如不小心把静态文件中间件删掉了？
  • web.config（如果是IIS兼容模式）：aspNetCore节点的processPath是不是正确指向dotnet或者你的应用dll？有没有误改了环境变量？
  • wwwroot目录：有没有误删静态文件或者改了目录结构？
• 看Azure部署日志：在Azure Portal的「部署中心」→「日志」里，看看最近的发布有没有报错——比如文件上传失败、NuGet包安装出错，这些都会导致网站启动失败。

• 检查文件系统权限：有时候部署后的文件权限不对，ASP.NET Core进程读不了配置或者静态文件。用Azure Portal的「高级工具」→「Kudu控制台」，进入site/wwwroot目录，Windows环境右键看文件权限，Linux环境敲ls -l命令，确保应用池身份（Windows是IIS APPPOOL\你的应用池名，Linux是www-data）有读取权限。
• 排查身份验证配置：如果你的应用开了Azure AD或者其他身份验证，可能是最近改了权限规则，导致匿名访问被拒。去「认证」→「身份验证提供商」里看看，是不是开了「需要身份验证」但没配置好允许访问的用户/角色，或者回调URL写错了。

• 开启ASP.NET Core详细日志：把appsettings.json里的日志级别调到Debug或者Information，重新发布后，去Azure Portal的「日志流」里看实时日志——这里一般会显示具体的错误原因，比如路由找不到、数据库连接失败、哪个文件权限不足。
• 查看IIS日志（Windows环境）：在Kudu控制台进入LogFiles\W3SVCxxxx目录，打开最新的日志文件，里面会记录每个请求的状态码和错误细节，比如403.14就是目录浏览被禁用且没设默认文档，403.7是客户端证书的问题。

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