Azure通过zip部署PHP应用提示资源不存在、web.config配置无效如何解决

你当前使用的web.config重写规则是为前端单页应用设计的，完全不适配PHP项目，是导致报错的核心原因之一，可按以下步骤依次排查：

1. 优先替换适配PHP的web.config配置 #

直接替换现有web.config内容为以下配置，可适配绝大多数PHP框架（原生PHP、Laravel、ThinkPHP等）：

<configuration>
  <system.webServer>
    <!-- 注册PHP FastCGI处理器 -->
    <handlers>
      <add name="PHP_via_FastCGI" path="*.php" verb="*" modules="FastCgiModule" scriptProcessor="D:\Program Files (x86)\PHP\v对应PHP版本号\php-cgi.exe" resourceType="Either" requireAccess="Script" />
    </handlers>
    <!-- PHP项目通用重写规则 -->
    <rewrite>
      <rules>
        <rule name="PHP Rewrite Rule" stopProcessing="true">
          <match url="^(.*)$" ignoreCase="false" />
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsFile" ignoreCase="false" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" ignoreCase="false" negate="true" />
          </conditions>
          <action type="Rewrite" url="index.php/{R:1}" appendQueryString="true" />
        </rule>
      </rules>
    </rewrite>
    <!-- 配置默认入口文档 -->
    <defaultDocument>
      <files>
        <clear />
        <add value="index.php" />
        <add value="index.html" />
      </files>
    </defaultDocument>
  </system.webServer>
</configuration>

注意：配置中的scriptProcessor路径需要和你Azure应用服务安装的PHP版本对应，可在Azure门户「应用服务-配置-常规设置」中查看已选PHP版本后替换对应版本号

2. 检查站点根目录映射 #

• 进入Azure应用服务面板，打开「配置-路径映射」
• 确认虚拟路径/对应的物理路径是否为项目入口目录：如果是Laravel等需要隐藏入口文件的框架，需要映射到site\wwwroot\public，原生PHP项目映射到site\wwwroot即可
• 配置完成后保存并重启应用服务生效

3. 验证部署文件完整性 #

• 进入Azure应用服务的「高级工具(Kudu)」，选择Debug console->PowerShell
• 进入site\wwwroot目录，检查所有项目文件是否完整上传，确认没有漏传.env、入口文件等核心配置
• 在Kudu控制台执行php -v确认线上PHP版本和本地开发版本一致，避免版本兼容问题

4. 开启调试日志定位具体问题 #

• 进入Azure应用服务「配置-应用设置」，添加两个配置项：
  • PHP_ERROR_REPORTING 值设为 E_ALL
  • DISPLAY_ERRORS 值设为 On
• 保存重启应用后再次访问报错页面，即可看到具体的PHP执行报错信息，而非通用404提示，方便定位具体问题
• 问题解决后请关闭上述两个配置，避免泄露敏感信息

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