Azure App Service Nginx迁移Apache：PHP页面下载不渲染问题排查

一、当前Nginx配置的错误点 #

1. Rewrite规则的Flag使用错误 #

你的location /refer块中使用了break flag，这会导致重写后的请求不会触发后续的Location匹配。当/refer被重写为/refer.php后，Nginx不会进入处理PHP的location ~ \.php$块，而是直接将refer.php作为静态文件返回，这是PHP页面被下载或显示源码的核心原因之一。

修改方式：将break改为last，让Nginx重新匹配重写后的URI：

location /refer {
  rewrite ^/refer /refer.php last;
}

2. 不必要的default_type text/html;配置 #

打开该配置后，Nginx会将所有未匹配到MIME类型的文件（包括PHP文件）以text/html格式返回，直接输出PHP源码而不交给PHP-FPM解析，因此必须保持该配置注释状态。

3. 额外检查点 #

确认fastcgi_pass 127.0.0.1:9000是否与Azure App Service中PHP-FPM的运行地址一致。在Azure Linux PHP环境中，部分版本可能使用Unix Socket（如/run/php/php7.4-fpm.sock），如果上述修改后仍存在问题，可以尝试替换为对应版本的Socket路径，比如：

fastcgi_pass unix:/run/php/php8.2-fpm.sock;

（具体路径可通过Azure App Service的SSH终端查看/etc/php/*/fpm/pool.d/www.conf中的listen配置）

二、Azure App Service中编辑Nginx配置的方法 #

Azure App Service Linux环境不允许直接修改默认的nginx.conf，但支持通过自定义配置覆盖或扩展Nginx规则：

• 方法1：使用自定义Server块配置
  在项目根目录的/home/site/nginx/目录下创建default.conf文件（目录不存在则手动创建），将你的自定义Nginx Server配置写入该文件，App Service会自动加载这个配置并覆盖默认的Server块。

• 方法2：通过.nginx.conf文件扩展配置
  在项目根目录创建.nginx.conf文件，写入需要添加或修改的Nginx规则（比如额外的rewrite、location配置），App Service会将这些规则合并到默认的Nginx配置中。

• 方法3：启动脚本自定义
  如果需要更复杂的配置修改，可以在项目根目录创建startup.sh脚本，在脚本中修改Nginx配置文件并启动服务，然后在Azure门户的应用服务>配置>常规设置>启动命令中指定该脚本路径（如/home/site/wwwroot/startup.sh）。

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