一、问题/场景描述
在部署或迁移基于ThinkPHP框架开发的项目时，访问网站页面经常出现404错误，但项目代码和路由配置确认无误。这种情况在Apache服务器环境下尤为常见，通常与项目根目录下的.htaccess文件有关。
二、原因分析
ThinkPHP项目在Apache服务器上运行时，通常依赖.htaccess文件实现URL重写，将请求引导至项目的入口文件（通常是public/index.php）。如果该文件丢失、内容错误，或者Apache未开启mod_rewrite模块，都会导致所有非静态资源的请求无法正确路由，从而触发404错误。此外，文件权限问题或.htaccess文件所在目录的Apache配置覆盖也可能导致规则失效。
三、详细解决步骤
请按照以下步骤逐一排查和解决问题。
步骤1：检查.htaccess文件是否存在
首先，通过SSH或FTP工具连接到服务器，确认项目public目录下是否存在.htaccess文件。如果文件丢失，需要重新创建。
# 进入ThinkPHP项目的public目录
cd /path/to/your/project/public
# 检查.htaccess文件
ls -la .htaccess
步骤2：创建或修复.htaccess文件内容
如果文件不存在，请创建一个新的.htaccess文件。如果文件存在但内容可能错误，请用以下标准内容覆盖。这是ThinkPHP官方推荐的配置。
Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]
步骤3：确保Apache已启用mod_rewrite模块
URL重写功能需要Apache的rewrite模块支持。使用以下命令启用它，并重启Apache服务。
# 对于Ubuntu/Debian系统
sudo a2enmod rewrite
sudo systemctl restart apache2
# 对于CentOS/RHEL系统
# 通常mod_rewrite默认已启用，可检查httpd.conf中是否有LoadModule rewrite_module modules/mod_rewrite.so
sudo systemctl restart httpd
步骤4：检查Apache目录配置，允许.htaccess覆盖
Apache主配置或虚拟主机配置中，必须允许.htaccess文件覆盖当前目录的配置。找到对应站点的配置文件，确保相关目录的AllowOverride设置为All。
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
修改配置后，务必重启Apache服务使配置生效。
步骤5：检查文件权限与路径
确保.htaccess文件具有可读权限，并且ThinkPHP项目的入口文件路径正确。同时，检查项目是否部署在正确的网站根目录（通常是public目录）。
# 设置正确的文件权限（通常644即可）
chmod 644 /path/to/your/project/public/.htaccess
# 确认目录结构正确
ls -la /path/to/your/project/public/index.php
四、注意事项
在操作前建议备份原有的.htaccess文件。修改Apache配置后，务必使用apachectl configtest或nginx -t（如为Nginx）测试配置语法是否正确，然后再重启服务，避免导致服务无法启动。如果网站使用了CDN或防火墙，请确保其规则不会拦截或修改重写规则。
五、适用环境
本解决方案主要适用于使用Apache作为Web服务器、并通过.htaccess进行URL重写的ThinkPHP项目。