nginx 固定链接 404

原标题：nginx 固定链接 404

导读：

# Nginx固定链接404？详解WordPress等系统的URL重写解决方案在使用Nginx作为Web服务器时，固定链接（如WordPress的`/%postname%...

Nginx固定链接404？详解WordPress等系统的URL重写解决方案

在使用Nginx作为Web服务器时，固定链接（如WordPress的/%postname%.html）突然出现404错误是常见问题。这类错误不仅影响用户访问体验，还可能导致SEO权重流失。本文从原理到实操，详细解析Nginx环境下固定链接404的成因及解决方案，帮助开发者快速定位并修复问题。

一、问题现象与影响

固定链接404的典型表现是：访问带有自定义结构的URL（如example.com/post/123）时，浏览器显示“404 Not Found”，但静态页面（如图片、CSS）和首页能正常加载。若未及时处理，会导致用户无法访问历史文章、分类页等核心内容，直接影响流量和转化。

二、核心原因分析

Nginx默认不处理动态URL重写，固定链接404本质是URL路由规则缺失或配置错误，常见成因有以下4类：

1. Nginx未启用URL重写模块

Nginx的rewrite功能依赖http_rewrite_module模块，若编译时未包含该模块（如nginx -V查看配置无--with-http_rewrite_module），则无法解析动态URL。此时即使配置了重写规则，Nginx也会直接返回404。

2. URL重写规则错误

固定链接需将用户请求“伪装”为静态资源，实际转发至后端PHP程序（如WordPress的index.php）。若规则缺失或参数错误，会导致请求无法正确分发：

try_files规则失效：Nginx无法按顺序检查文件、目录，直接跳过index.php转发。
rewrite循环重写：规则未加last或break标记，导致URL无限重写（如rewrite ^(.*)$ /index.php后再次进入Nginx循环，最终超时返回404）。

3. FastCGI配置不完整

Nginx需通过FastCGI将动态请求转发至PHP解析器（如php-fpm）。若fastcgi_param参数缺失（如未设置SCRIPT_FILENAME），PHP无法识别请求的处理路径，返回“文件未找到”。

4. 权限或路径配置错误

PHP文件权限（如index.php所有者非Nginx用户）或网站根目录路径错误，可能导致Nginx无法访问目标文件，间接触发404。

三、分步解决方案

以下以WordPress为例（其他CMS如Drupal/Magento原理类似，可参考调整），提供可落地的Nginx配置修复步骤：

步骤1：验证Nginx是否启用rewrite模块

执行nginx -V查看编译参数，检查是否包含--with-http_rewrite_module。若未启用，需重新编译Nginx（或直接替换为已启用该模块的二进制包）。

步骤2：配置URL重写规则

在Nginx的server块中添加以下规则（示例为WordPress标准配置）：

server {
    listen 80;
    server_name example.com;
    root /var/www/html;  # 网站根目录

    # 处理固定链接的核心规则
    location / {
        try_files $uri $uri/ /index.php?$args;  # 优先检查文件、目录，否则转发至index.php
        expires 1d;  # 静态资源缓存（可选）
    }

    # 指向PHP-FPM的FastCGI配置
    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;  # PHP-FPM进程地址
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  # 关键参数
        include fastcgi_params;
    }
}

规则说明：

try_files $uri $uri/ /index.php?$args：按顺序检查当前URL是否为文件/目录，若均不存在，将请求参数（如文章ID）追加到index.php后，转发给PHP解析。
expires 1d：缓存静态资源，减轻服务器压力，不影响动态内容。

步骤3：检查并修正FastCGI参数

在location ~ \.php$块中，确保fastcgi_param包含以下关键参数：

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;  # 支持PATHINFO模式（如WordPress多站点）
fastcgi_param QUERY_STRING $query_string;    # 传递URL参数

若参数缺失，PHP无法识别请求目标文件，导致404。

步骤4：测试与验证

语法检查：执行nginx -t，确保配置文件无语法错误。
重启服务：nginx -s reload使配置生效。
手动测试：访问固定链接（如example.com/post/123），若返回正常页面，说明修复成功。

四、常见误区与排查技巧

重复配置location /：若同时存在location /和location ~ \.php$，需确保location /优先级更高，避免规则冲突。
忽略last标记：若使用rewrite规则替代try_files，必须添加last（如rewrite ^(.*)$ /index.php last;），否则会导致无限重写。
权限问题：若Nginx无法读取index.php或目标文件，检查文件所有者（chown -R nginx:nginx /var/www/html）。