一、问题/场景描述
在Apache服务器上部署ThinkPHP项目时，访问除首页外的其他路由页面，系统返回404 Not Found错误。然而，项目在本地开发环境或Nginx服务器上运行正常。此问题通常是由于Apache的URL重写模块（mod_rewrite）未正确启用或配置所致，导致框架的路由规则无法生效。
二、原因分析
ThinkPHP框架采用单一入口模式，并通过URL重写（路由）来隐藏入口文件index.php，实现友好的URL。当Apache服务器的mod_rewrite模块未启用，或者项目根目录下的.htaccess文件未被正确识别时，所有指向应用内部路由的请求都会被视为对物理文件的请求。由于这些路径对应的物理文件不存在，Apache便会直接返回404错误。核心原因在于Apache未能将请求重写到ThinkPHP的入口文件上。
三、详细解决步骤
解决此问题需要确保Apache的rewrite模块已启用，并且.htaccess文件配置正确。以下是详细的排查与修复步骤。
步骤1：确认并启用mod_rewrite模块
首先，需要检查Apache的rewrite模块是否已加载。在终端执行以下命令。
sudo a2enmod rewrite执行后，系统会提示模块已启用或需要重启Apache。然后，必须重启Apache服务使配置生效。
sudo systemctl restart apache2
# 或者使用 service apache2 restart步骤2：配置Apache以允许.htaccess重写
默认情况下，Apache可能不允许在特定目录中使用.htaccess文件覆盖配置。需要修改对应站点的虚拟主机配置文件，确保AllowOverride设置为All。找到你的站点配置文件（通常在 /etc/apache2/sites-available/ 目录下）。
sudo vim /etc/apache2/sites-available/000-default.conf在 或对应项目根目录的配置段中，修改或添加如下指令：
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
保存退出后，再次重启Apache服务。
sudo systemctl reload apache2步骤3：检查并配置项目中的.htaccess文件
确保ThinkPHP项目根目录（与public目录同级，或者如果你的入口在public内，则在public目录下）存在正确的.htaccess文件。标准ThinkPHP项目的.htaccess内容通常如下：
Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
请根据你的入口文件实际位置（如 public/index.php）调整RewriteRule的最后一行。例如，如果入口文件在public目录内，规则应为：RewriteRule ^(.*)$ public/index.php/$1 [QSA,PT,L]。
步骤4：验证配置是否生效
完成以上步骤后，访问一个ThinkPHP的内部路由（如：http://yourdomain.com/about）。如果页面能正常显示，而非404，则说明重写规则已成功启用。你也可以创建一个简单的PHP信息文件来测试Apache是否已加载rewrite模块。
echo "" > /var/www/html/test.php然后在浏览器中访问该文件，搜索“mod_rewrite”，确认其已处于激活状态。
四、注意事项
在修改Apache配置后，务必使用sudo apache2ctl configtest或apachectl -t命令测试配置文件语法是否正确，避免因配置错误导致整个服务无法启动。同时，确保.htaccess文件的路径和其中的RewriteRule规则与你的项目实际目录结构匹配，这是最常见导致规则失效的原因之一。
五、适用环境
本解决方案适用于在Apache 2.x服务器上部署ThinkPHP 5.x或6.x系列框架项目时，遇到的因URL重写功能未启用而导致的404错误场景。