一、问题/场景描述
在Linux服务器上部署ThinkPHP项目后，访问网站页面时，部分或全部路由返回404错误。然而，项目代码、Nginx或Apache配置均已正确设置，且通过命令行测试框架运行正常。这种问题通常与服务器文件系统的权限配置有关。
二、原因分析
ThinkPHP框架在运行时，需要特定的目录具有可写权限，以便生成运行时缓存、日志文件等。如果这些关键目录（如runtime目录）的权限设置不当，Web服务器进程（如www-data或nginx用户）将无法在其中创建或读取必要的文件。这会导致框架的URL路由解析、配置文件加载失败，从而引发404错误，而非更明确的权限拒绝错误，增加了排查难度。
三、详细解决步骤
解决此问题的核心是确保Web服务器进程对项目目录，尤其是runtime目录拥有正确的读写权限。请按照以下步骤检查和修复。
步骤1：定位Web服务器运行用户
首先，需要确定您的Web服务器（Nginx或Apache）是以哪个系统用户身份运行的。执行以下命令查看。
# 对于 Nginx
ps aux | grep nginx
# 对于 Apache (httpd)
ps aux | grep apache
ps aux | grep httpd通常，Nginx的运行用户是nginx或www-data，Apache的运行用户是apache或www-data。请记下这个用户名，假设为www-data。
步骤2：检查项目目录所有权和权限
进入您的ThinkPHP项目根目录，检查目录的所有者和权限。错误的文件所有者是常见问题。
# 进入项目目录，例如 /var/www/tp_project
cd /var/www/tp_project
# 查看当前目录下所有文件和子目录的详细信息
ls -la重点关注runtime目录。如果其所有者是您的个人用户（如root或ubuntu），而Web服务器用户是www-data，则www-data可能没有写入权限。
步骤3：修正目录所有权和权限
最安全有效的方法是将项目目录的所有者更改为Web服务器用户，并确保runtime目录具有可写权限。请根据您的Web服务器用户进行替换。
# 将项目根目录及其下所有文件的所有者改为 www-data 用户和组
sudo chown -R www-data:www-data /var/www/tp_project/
# 确保目录具有适当的权限（755为目录，644为文件是一个安全的起点）
# 首先设置目录为755权限
sudo find /var/www/tp_project -type d -exec chmod 755 {} ;
# 然后设置文件为644权限
sudo find /var/www/tp_project -type f -exec chmod 644 {} ;
# 特别为runtime目录设置可写权限（775权限允许同组用户写入）
sudo chmod -R 775 /var/www/tp_project/runtime/如果出于安全考虑不希望更改整个项目目录的所有者，可以仅更改runtime、public/uploads等需要写入的目录。
sudo chown -R www-data:www-data /var/www/tp_project/runtime/
sudo chmod -R 775 /var/www/tp_project/runtime/步骤4：验证SELinux或AppArmor（如适用）
在某些严格的安全策略下（如CentOS的SELinux），即使权限正确，也可能被安全模块阻止。可以临时禁用SELinux进行测试。
# 临时将SELinux设置为宽容模式
sudo setenforce 0如果问题解决，则需要为Web目录添加上下文标签。
# 为项目目录设置合适的SELinux上下文
sudo chcon -R -t httpd_sys_rw_content_t /var/www/tp_project/runtime/步骤5：重启Web服务并测试
完成权限修改后，重启Web服务器使配置生效，然后刷新浏览器测试页面。
# 重启 Nginx
sudo systemctl restart nginx
# 或重启 Apache
sudo systemctl restart apache2
sudo systemctl restart httpd此时，之前返回404的页面应该能够正常访问了。
四、注意事项
在修改权限时，应遵循最小权限原则，避免将整个项目目录设置为777权限，这会带来严重的安全风险。建议仅对需要写入的特定目录（如runtime）放宽权限。同时，在生产环境中操作前，最好在测试环境验证，并确保有完整的备份。
五、适用环境
此问题常见于使用Nginx或Apache作为Web服务器的Linux生产环境，尤其是在项目从开发环境迁移或通过FTP、SCP等方式上传文件后。