一、问题/场景描述
在ThinkPHP项目部署上线后，有时出于安全或目录结构调整的需要，开发者会修改入口文件（通常是public目录下的index.php）的位置。然而，修改后访问网站却出现了404 Not Found错误，页面无法正常加载，而代码本身并无问题。
二、原因分析
该问题的主要原因在于Web服务器（如Nginx或Apache）的配置未能同步更新。服务器配置中通常指定了网站根目录和入口文件的位置。当入口文件被移动后，原有的配置路径失效，导致服务器无法找到正确的处理脚本。此外，ThinkPHP框架自身的路由机制依赖于入口文件来引导请求，入口文件路径错误会使得整个应用的路由解析失败，从而触发404错误。
三、详细解决步骤
解决此问题的核心是同步更新Web服务器的配置，确保其指向新的入口文件路径。以下是针对Nginx和Apache的详细配置步骤。
步骤1：确认新的入口文件路径
首先，明确你的入口文件移动到了哪个目录。例如，原路径为 /www/wwwroot/project/public/index.php，新路径为 /www/wwwroot/project/new_public/index.php。
步骤2：修改Nginx服务器配置
如果你使用的是Nginx，需要编辑对应的站点配置文件（通常在 /etc/nginx/sites-available/ 或 /etc/nginx/conf.d/ 目录下）。找到 root 和 location ~ .php$ 相关配置项进行修改。
server {
listen 80;
server_name yourdomain.com;
# 将root指向新的public目录所在路径
root /www/wwwroot/project/new_public;
index index.php index.html index.htm;
location / {
try_files $uri $uri/ /index.php?s=$uri&$args;
}
location ~ .php$ {
# 确保fastcgi_param SCRIPT_FILENAME指向新的入口文件路径
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
修改完成后，检查配置语法并重载Nginx。
sudo nginx -t
sudo systemctl reload nginx
步骤3：修改Apache服务器配置（.htaccess）
如果使用Apache，通常通过项目目录下的 .htaccess 文件进行配置。你需要修改或确保 .htaccess 文件位于新的入口文件同级目录，并且其中的重写规则正确。
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 确保重写目标指向新的入口文件index.php
RewriteRule ^(.*)$ index.php?s=/$1 [QSA,PT,L]
同时，检查Apache的虚拟主机配置，将 DocumentRoot 指向新的目录。
DocumentRoot "/www/wwwroot/project/new_public"
修改后重启Apache服务。
sudo systemctl restart apache2
步骤4：清除ThinkPHP路由缓存
配置更新后，建议清除ThinkPHP的运行时缓存，确保路由信息重新生成。
# 进入项目根目录（与application目录同级）
cd /www/wwwroot/project
# 清除缓存（ThinkPHP 6.x+）
php think clear
# 或手动删除runtime目录（谨慎操作）
# rm -rf runtime/*
四、注意事项
修改服务器配置前务必做好备份。对于生产环境，建议先在测试环境验证。修改后，不仅要检查主页面，还应测试带参数的动态路由是否正常。如果使用了伪静态规则，需确保规则与新目录结构兼容。
五、适用环境
本解决方案适用于部署了ThinkPHP框架，并使用Nginx或Apache作为Web服务器的Linux生产或开发环境。