Azure WebApp安装WordPress第二步提交数据库信息出现NGINX 404错误

你看到的Nginx 404是假错误，本质是PHP处理安装请求时触发了服务端错误，Nginx尝试加载配置中指定的/html/50x.html错误页失败，才返回了404状态码，favicon.ico的报错属于无关项，是站点未设置图标导致的，无需处理。

排查步骤 #

1. 暴露真实服务端错误 #

• 登录Azure WebApp的SSH控制台，找到Nginx站点配置文件，默认路径为/etc/nginx/conf.d/default.conf，注释掉配置中的fastcgi_intercept_errors on参数，或者将error_page 500 502 503 504 /50x.html的对应root路径修改为你的站点根目录/home/site/wwwroot，修改完成后执行nginx -s reload重载配置。
• 开启WordPress调试模式：编辑站点根目录下的wp-config-sample.php，将调试参数修改为：

  define( 'WP_DEBUG', true );
  define( 'WP_DEBUG_DISPLAY', true );
  

  重新提交安装表单，即可看到真实的PHP错误提示，定位具体问题。

2. 排查常见故障点 #

• 验证数据库连通性：确认填写的数据库地址、端口、用户名、密码、库名完全匹配你创建的数据库实例配置，如果你使用Azure Database for MySQL/PostgreSQL，需要确认数据库防火墙已开放允许Azure服务访问的规则，同时数据库已开启公网访问权限。
• 修正目录权限：运行PHP的进程用户默认无站点目录写入权限，执行以下命令修正权限：

  chown -R www-data:www-data /home/site/wwwroot
  chmod -R 755 /home/site/wwwroot
  

  避免WordPress无法写入生成wp-config.php文件导致安装失败。
• 补充Nginx伪静态规则：在Nginx站点配置的server块中添加如下规则，保证请求正确转发到WordPress入口文件：

  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }
  

  修改后执行nginx -s reload生效。

3. 手动绕过安装配置步骤 #

如果提交表单始终失败，可手动生成配置文件完成安装：

• 将站点根目录下的wp-config-sample.php重命名为wp-config.php
• 手动编辑文件内的数据库连接配置项，填入正确的数据库信息后保存
• 直接访问站点域名，会自动跳过数据库配置步骤，进入管理员账号设置流程，完成站点安装。

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