ThinkPHP 8.0在Apache下必须启用mod_rewrite模块、设置AllowOverride All、DocumentRoot指向public目录，否则除首页外均404；需验证模块启用、检查.htaccess存在且生效、确保重写规则含PT标志并适配Apache 2.4+语法。
ThinkPHP 8.0 在 Apache 下必须启用重写（mod_rewrite），否则除首页外所有路由都会 404；默认配置不生效，需手动开启并调整 .htaccess 或主配置文件。
Apache 是否已启用 mod_rewrite 模块
ThinkPHP 8.0 的 URL 路由依赖 Apache 的 mod_rewrite 模块。如果没启用，index.php 后面的路径（如 /user/list）会被当作子目录处理，直接 404。
- 检查是否启用：
apache2ctl -M | grep rewrite（Linux）或httpd -M | grep rewrite（macOS/Windows WAMP）；输出含rewrite_module (shared)才算启用 - 未启用时，在
httpd.conf中取消注释这行：LoadModule rewrite_module modules/mod_rewrite.so - Windows 用户注意：部分集成环境（如 XAMPP、WampServer）默认禁用该模块，需在图形界面中勾选 “rewrite_module” 并重启服务
DocumentRoot 目录下必须有有效的 .htaccess 文件
ThinkPHP 8.0 官方推荐将 Web 入口放在 public/ 目录，且该目录内自带 .htaccess。但这个文件在 Apache 默认配置下常被忽略——不是它不存在，而是 Apache 不允许读取或执行它。
- 确保
AllowOverride All已设置在对应<directory></directory>块中，例如：<Directory "/var/www/html/your-project/public"> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> - 若使用虚拟主机，
AllowOverride All必须写在<VirtualHost>内部的<Directory>块里，不能只写在全局配置中 - Windows 系统要注意：资源管理器默认隐藏以
.开头的文件，需手动显示隐藏文件，并确认.htaccess真实存在且内容未被清空（常见错误是复制时丢掉点号，变成htaccess）
重写规则本身要适配 Apache 2.4+ 语法
ThinkPHP 8.0 的 .htaccess 默认使用 Apache 2.4 语法，但如果你的服务器是旧版 Apache 2.2（如 CentOS 6 自带版本），Require all granted 会报错，而 Order deny,allow 在 2.4+ 中已被废弃。
立即学习“PHP免费学习笔记（深入）”；
- 标准 ThinkPHP 8.0
.htaccess内容应类似：RewriteEngine on RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L] - 关键点：
[QSA,PT,L]中的PT（pass-through）不可省略，否则 Laravel/ThinkPHP 类框架的子请求路径无法正确传递给index.php - 若遇到重写后出现
No input file specified.，大概率是 PHP 运行模式为 CGI/FastCGI 且未正确传递 PATH_INFO；此时可改用兼容性更强的写法：RewriteRule ^(.*)$ index.php?/$1 [QSA,L]
，并在config/app.php中设置'url_common_param' => true
DocumentRoot 指向 public 目录，而非项目根目录
这是最容易被忽略的一步：ThinkPHP 8.0 不再支持将整个项目目录设为 Web 根，app/、config/、runtime/ 等敏感目录必须禁止 Web 访问。硬编码路径或错误配置会导致 500 或泄露配置文件。
- 正确做法：把 Apache 的
DocumentRoot改成项目内public/子目录，例如：DocumentRoot "/var/www/myapp/public" - 同时确保
public/的父目录（如/var/www/myapp）权限不开放 Web 访问——Apache 默认不会自动禁止，需靠目录级配置或系统权限控制 - 若因部署限制无法修改
DocumentRoot（如共享主机），则必须在项目根目录的.htaccess中添加显式拒绝规则，例如：<FilesMatch "^\.|config|app|runtime|vendor"> Require all denied </FilesMatch>
真正卡住人的往往不是规则写错，而是 AllowOverride 没生效、.htaccess 被忽略、或 DocumentRoot 指错了位置——这三个点查完，90% 的 ThinkPHP 8.0 Apache 路由问题就解决了。
