WordPress 访问 503 与 Nginx 代理配置问题解决

根因#

Nginx 的 80 端口配置中，location / 将所有请求（包括 *.php）全部代理至 Spring Boot（http://127.0.0.1:8080），导致 WordPress 的 PHP 脚本被错误转发到 Java 后端。Spring Boot 无法处理 .php 路由，返回 404 Whitelabel 错误。

后续修正 PHP 请求转发后出现维护页面，是因为 WordPress 根目录下存在 .maintenance 文件，表明之前发生过中断的自动更新，导致站点进入维护模式。

检查 Nginx 配置#

查看当前 Nginx 配置文件，发现 80 端口的 server 块仅包含：

1
location / {
2
    proxy_pass http://127.0.0.1:8080;
3
    ...
4
}

未配置任何 location ~ \.php$ 规则，导致所有 .php 请求均被代理到 Spring Boot。

确定 WordPress 安装路径#

1
find / -name wp-config.php 2>/dev/null

确认 PHP-FPM 状态及监听方式#

1
systemctl status php-fpm
2
# 显示 active (running)
3

4
grep "^listen" /usr/local/php/etc/php-fpm.conf
5
# 输出：listen = /tmp/php-cgi.sock

确认 PHP-FPM 使用 Unix Socket 通信，非 TCP 端口。

配置文件换行符问题#

用 vim 打开 Nginx 配置文件时，行尾出现大量 ^M 字符（Windows CRLF 格式），可能导致 Nginx 解析错误。

排查维护模式#

在修正 PHP 转发后访问出现”正在执行例行维护”页面，检查 WordPress 根目录存在 .maintenance 文件。

修改 Nginx 配置，增加 PHP 处理规则#

在监听 80 端口的 server 块中，在 location / 之前添加专门处理 .php 请求的 location：

1
server {
2
    listen       80;
3
    server_name  intmotecare.com;
4

5
    # PHP 请求转发至 PHP-FPM
6
    location ~ \.php$ {
7
        root           /home/wwwroot/wordpress;
8
        fastcgi_pass   unix:/tmp/php-cgi.sock;
9
        fastcgi_index  index.php;
10
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
11
        include        fastcgi_params;
12
    }
13

14
    # 其他请求代理到 Spring Boot
15
    location / {
16
        proxy_pass         http://127.0.0.1:8080;
17
        proxy_set_header   Host $host;
18
        proxy_set_header   X-Real-IP $remote_addr;
19
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
20
        proxy_set_header   X-Forwarded-Proto $scheme;
21
    }
22
}

处理配置文件换行符#

1
yum install dos2unix -y
2
dos2unix /usr/local/nginx/conf/nginx.conf

或通过 Vim 内部命令：

1
:set fileformat=unix
2
:wq

删除 WordPress 维护模式标记文件#

1
rm -f /home/wwwroot/wordpress/.maintenance

验证并重载 Nginx#

1
nginx -t        # 检查语法
2
nginx -s reload # 重载配置

问题根源#

• Nginx location 优先级：未明确区分动态 PHP 请求，导致错误转发到 Spring Boot
• 文件格式：跨平台编辑导致配置文件包含 Windows 换行符，影响 Nginx 解析
• WordPress 维护文件残留：更新中断后未自动清理，阻塞访问

预防措施#

1. 规划 location 匹配顺序：将特定后缀（如 .php）的 location 放在通用 location / 之前，确保精确匹配优先
2. 统一换行符：在 Linux 服务器上直接编辑配置文件，或使用编辑器设置默认换行符为 LF
3. 监控 WordPress 更新：若更新卡住，定期检查并手动清理 .maintenance 文件（确保更新进程已结束）
4. 日志监控：关注 Nginx 错误日志（/var/log/nginx/error.log）和 PHP-FPM 日志

命令速查#