thinkphp8路由出现404通常是因为web服务器未正确配置伪静态规则导致请求未进入入口文件，或者应用内部的路由缓存与当前代码不一致。排查时，首先确认nginx或apache的配置文件是否正确将非静态资源请求转发至public/index.php，其次检查runtime目录下的route.php缓存文件是否过期，手动删除该文件可强制系统重新生成路由。
Nginx伪静态配置缺失导致请求被拦截
如果服务器环境是Nginx，最常见的错误是在虚拟主机配置中遗漏了try_files指令，导致浏览器直接请求不存在的物理路径而返回404。正确的做法是在server块中添加try_files $uri $uri/ /index.php?$query_string;，确保所有未匹配到的URI都交由入口文件处理。
server {
listen 80;
server_name example.com;
root /path/to/thinkphp/public;
# 关键配置：将请求重定向到入口文件
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php-fpm/www.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
上述配置中，当用户访问/example时，Nginx会先尝试查找同名文件或目录，若不存在则重写为/index.php?query_string=/example，从而触发ThinkPHP的路由解析。若缺少此行，Nginx会直接返回404 Not Found，且不会经过任何PHP逻辑。
立即学习“PHP免费学习笔记（深入）”；
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
Apache .htaccess规则失效或权限问题
在Apache环境下，ThinkPHP依赖根目录下的.htaccess文件启用mod_rewrite模块。如果该文件丢失、内容错误或Apache配置中AllowOverride未设置为All，伪静态将失效。需检查public/.htaccess是否存在，并确保其包含标准的RewriteRule指令，同时验证Apache的httpd.conf中LoadModule rewrite_module和AllowOverride All已生效。
# public/.htaccess
<IfModule mod_rewrite.c>
Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>
此规则通过判断请求是否为真实文件或目录来决定是否重写。若AllowOverride为None，Apache将忽略此文件，导致所有动态路由均返回404。修改配置后需重启Apache服务以加载新规则。
路由缓存文件未更新导致旧路由生效
ThinkPHP8默认开启路由缓存以提升性能，但开发阶段代码变更后，runtime/route.php可能未及时刷新，导致新定义的路由无法识别。解决方法是手动删除runtime目录下的route.php文件，或在config/app.php中将app_status设为debug模式以禁用缓存。删除缓存后，系统会在首次请求时重新扫描路由文件并生成新的缓存。
