404主因是请求未进入ThinkPHP路由系统，需先验证/index.php/route/test是否触发调试页；若返回原生404且无X-Powered-By头，则问题在入口接管，应检查Nginx的root路径、try_files指令及fastcgi_param配置，或Apache的AllowOverride设置与.htaccess文件名及内容。
404 不是路由写错了，而是请求压根没进 ThinkPHP 的路由系统——绝大多数情况，问题出在 Web 服务器配置或框架入口接管失败上。
先确认请求是否真正进入 ThinkPHP
这是最关键的一步，跳过它直接改路由代码全是白忙活。
- 访问
http://localhost/index.php/route/test（确保该路由未定义）：如果看到 ThinkPHP 调试页提示「找不到路由」，说明框架已接管；如果返回 Nginx/Apache 原生 404 页面，且响应头里没有X-Powered-By: ThinkPHP，那就停在这里——问题出在入口接管环节 - 用
curl -I http://localhost/user/list看响应头：若只有Server: nginx而无 ThinkPHP 相关标识，说明 PHP 层根本没执行 - 运行
php think route:list：输出为空、或列表里根本没有你写的/user/list，代表route/app.php根本没被执行。此时在该文件第一行加die('route loaded');，刷新任意 URL，没中断 = 该文件被跳过
Nginx 用户重点查这三处配置
TP8 默认依赖 try_files 规则转发请求，漏掉或写错一个字符都会导致 404。
-
location /块内必须有且仅有一条try_files $uri $uri/ /index.php?$query_string;—— 缺$query_string会导致$_GET为空；写成/index.php?s=$1是 TP5 旧写法，TP8 不兼容 -
fastcgi_param SCRIPT_FILENAME必须设为$document_root$fastcgi_script_name，绝不能用$request_filename—— 后者在重写后可能指向错误路径，导致 PHP 解析失败 -
root指令必须指向public/目录（如root /var/www/myapp/public;），不是项目根目录，也不是public/index.php
Apache 用户常踩的两个硬坑
.htaccess 文件存在 ≠ 生效，很多 404 实际是 Apache 配置层面拒绝了重写规则。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
- 确认
public/.htaccess存在且内容标准，例如：RewriteEngine On、RewriteCond %{REQUEST_FILENAME} !-d、RewriteCond %{REQUEST_FILENAME} !-f、RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L] - 最关键的是检查 Apache 虚拟主机配置中对应
<directory></directory>块是否设置了AllowOverride All—— 只写AllowOverride FileInfo或漏掉这行，.htaccess 会被完全忽略 - Linux 服务器上，
.htaccess文件名必须全小写，写成.Htaccess或HTACCESS会直接失效
路由注册本身也容易失效
即使服务器转发正确，路由也可能因加载时机或位置不对而“隐身”。
- 路由必须写在
route/route.php（全局）或route/app.php（应用级），不能放在控制器、模型、中间件或钩子里 - 别在条件语句里动态注册，比如
if (env('APP_ENV') === 'dev') { Route::get(); }—— 环境变量可能尚未就绪，整段逻辑被跳过 - 用了
Route::group(['prefix' => 'api'])，但访问的是/user/list，前缀不匹配就不会进该组 - 清掉
runtime/cache/下所有文件再试，缓存会固化旧路由结构
最易被忽略的是大小写敏感和静态资源拦截：Linux 服务器下 /User/List 和 /user/list 是两个路径；开启 'url_route_must' => true 后，连 /static/logo.png 都会 404，得用 Route::rule() 显式放行后缀。
