一、问题/场景描述

在部署ThinkPHP应用后，访问网站首页正常，但点击任何其他链接或访问路由定义的页面时，均返回404 Not Found错误。这种情况通常发生在将应用从开发环境迁移到生产环境，或切换Web服务器（如从Apache切换到Nginx）之后。

二、原因分析

此问题的核心原因是Web服务器（如Nginx或Apache）的伪静态（URL重写）规则未正确配置或未启用。ThinkPHP框架采用了单一入口和路由机制，所有请求都应指向public/index.php文件。如果服务器未能将请求重写到该入口文件，框架就无法解析路由，从而导致除根目录外的所有页面请求直接映射到不存在的物理文件路径，触发404错误。这通常与服务器配置文件中的location（Nginx）或.htaccess（Apache）规则缺失或错误有关。

三、详细解决步骤

解决此问题需要根据您使用的Web服务器类型，配置正确的重写规则。以下是针对Nginx和Apache的详细配置步骤。

步骤1：确认ThinkPHP入口文件路径

首先，确认您的ThinkPHP项目入口文件位于public/index.php。这是所有请求应该被重定向到的目标。

步骤2：配置Nginx服务器规则

如果您使用的是Nginx，需要编辑对应站点的配置文件（通常在/etc/nginx/sites-available/或/etc/nginx/conf.d/目录下）。在server块中，找到处理PHP请求的location块，并确保其包含以下重写规则。

server {
    listen 80;
    server_name yourdomain.com;
    root /path/to/your/tp-project/public;
    index index.php index.html index.htm;

    location / {
        # 如果请求的不是真实存在的文件或目录
        if (!-e $request_filename) {
            # 则将请求重写到 index.php
            rewrite ^(.*)$ /index.php?s=$1 last;
            break;
        }
    }

    location ~ .php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock; # 根据您的PHP-FPM配置修改
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # 其他配置...
}

修改后，保存文件并测试Nginx配置是否正确，然后重启Nginx服务。

sudo nginx -t
sudo systemctl reload nginx

步骤3：配置Apache服务器规则（.htaccess）

如果您使用的是Apache，并且允许使用.htaccess文件，请确保public目录下存在该文件，且内容包含以下重写规则。同时，需确保Apache的mod_rewrite模块已启用，并且对应目录的AllowOverride设置允许读取.htaccess文件。



  Options +FollowSymlinks -Multiviews
  RewriteEngine On

  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php?s=$1 [QSA,PT,L]

对于Apache 2.4及以上版本，如果项目部署在子目录，可能需要额外调整。配置完成后，重启Apache服务。

sudo systemctl restart apache2

步骤4：检查ThinkPHP路由模式

确保ThinkPHP的路由模式与您的重写规则匹配。默认的兼容模式（s参数）与上述规则匹配。您可以在config/app.php文件中检查pathinfo_depr和url_route_on等配置。

四、注意事项

配置修改前务必备份原文件。Nginx的if指令需谨慎使用，在复杂配置中可能存在性能问题，可考虑使用try_files指令作为替代方案。对于Apache，确保httpd.conf中相关目录的AllowOverride All已设置，否则.htaccess文件不会生效。

五、适用环境

本解决方案适用于使用ThinkPHP 5.x/6.x/8.x框架，并部署在Nginx或Apache Web服务器环境下的情况。

ThinkPHP伪静态规则未正确配置导致所有页面404解决方法