一、问题/场景描述
在部署 ThinkPHP 应用时，为了获得更简洁的 URL，开发者通常会按照官方文档配置，隐藏 URL 中的 index.php 入口文件。然而，配置完成后访问网站，却出现了 404 Not Found 错误，页面无法正常打开，而带有 index.php 的原始链接却可以访问。
二、原因分析
出现此问题的核心原因是 Web 服务器（如 Nginx 或 Apache）未能正确地将请求重写到 ThinkPHP 的单一入口文件 index.php。对于 Nginx，通常是 location 配置块中的 try_files 指令或 rewrite 规则有误，导致服务器直接去寻找不存在的物理路径文件，从而返回 404。对于 Apache，则是 .htaccess 文件中的 RewriteRule 规则未被正确加载或配置错误。此外，服务器未开启 URL 重写模块（如 Apache 的 mod_rewrite）或项目根目录权限设置不当，也可能导致此问题。
三、详细解决步骤
以下分别针对 Nginx 和 Apache 服务器提供详细的配置检查和修正步骤。
步骤1：检查并修正 Nginx 配置
找到您的 Nginx 站点配置文件（通常在 /etc/nginx/conf.d/ 或 /etc/nginx/sites-available/ 目录下），检查对应 server 块内的 location / 配置。正确的配置应类似如下：
server {
listen 80;
server_name yourdomain.com;
root /path/to/your/tp/public;
index index.php index.html index.htm;
location / {
if (!-e $request_filename){
rewrite ^(.*)$ /index.php?s=$1 last; break;
}
}
location ~ .php$ {
fastcgi_pass unix:/run/php/php8.1-fpm.sock; # 根据你的PHP版本调整
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
另一种更推荐的方式是使用 try_files 指令：
location / {
try_files $uri $uri/ /index.php?s=$uri&$args;
}
修改配置后，务必使用以下命令测试配置并重载 Nginx：
sudo nginx -t
sudo systemctl reload nginx
步骤2：检查并修正 Apache 配置
首先，确保 Apache 的 mod_rewrite 模块已启用。然后，检查 ThinkPHP 项目 public 目录下的 .htaccess 文件内容是否正确。标准内容如下：
Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]
请确保该文件存在于网站根目录（通常是 public 目录），并且 Apache 配置中 AllowOverride 指令设置为 All，以允许 .htaccess 生效：
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
修改后，重启 Apache 服务：
sudo systemctl restart apache2 # 对于 Ubuntu/Debian
# 或
sudo systemctl restart httpd # 对于 CentOS/RHEL
步骤3：检查 ThinkPHP 路由和路径配置
确保 ThinkPHP 应用本身的 URL 重写模式已开启。检查 config/app.php 配置文件：
// 是否开启路由延迟解析
'url_lazy_route' => false,
// 是否强制使用路由
'url_route_must' => false,
// 合并路由规则
'route_rule_merge' => false,
// 路由是否完全匹配
'route_complete_match' => false,
// 默认应用
'default_app' => 'index',
同时，确认应用的入口文件绑定和伪静态设置正确。对于多应用模式，还需检查 app_namespace 和 app_map 等配置。
四、注意事项
在修改服务器配置前，请务必备份原文件。不同版本的 ThinkPHP（如 5.1， 6.0， 8.0）和不同版本的 Web 服务器，配置细节可能略有差异，请以对应官方文档为准。调试时，可先尝试访问一个简单的静态文件（如 robots.txt）以排除服务器根目录设置错误。
五、适用环境
本文适用于在 Linux 服务器上，使用 Nginx 或 Apache 部署 ThinkPHP 框架，并希望隐藏 URL 中 index.php 入口文件的场景。