伪静态未生效导致请求未进框架：/user/list报404而/index.php/user/list正常，说明Nginx或Apache未转发请求；Nginx需确认root指向public、location /含try_files $uri $uri/ /index.php?$query_string;、PHP块含fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;三者缺一不可。
伪静态没生效，请求根本没进框架
看到 /user/list 报 404，但 /index.php/user/list 能打开，这就是最明确的信号：Web 服务器没把请求转发给 ThinkPHP。Nginx 或 Apache 直接返回了原生 404，框架连初始化都没执行。
Apache 用户要确认两件事：.htaccess 文件真实存在于 public/ 目录下；对应虚拟主机配置中 AllowOverride All 已启用，不是 None。
Nginx 用户重点检查 server 块里有没有这行：
location / {
try_files $uri $uri/ /index.php?$query_string;
}注意三点：$query_string 必须保留，否则 ?id=123 这类参数会丢失；别写成 /index.php?s=$1，那是 TP5 的旧写法，TP8 不认；如果用了宝塔等面板，选完“ThinkPHP”模板后，一定要打开生成的配置文件，确认规则真写进去了，再执行 nginx -t && systemctl reload nginx。
立即学习“PHP免费学习笔记（深入）”；
入口文件路径或 PHP 配置错位
即使伪静态规则写了，root 指向错误也会导致 404。Nginx 的 root 必须指向项目 public/ 目录，不是项目根目录。比如实际路径是 /var/www/myapp/，那 root 应该是 /var/www/myapp/public。
另外两个常被忽略的底层配置：
-
cgi.fix_pathinfo = 1必须在php.ini中开启，改完记得重启php-fpm - Nginx 的
location ~ \.php$块里必须有这两行：fastcgi_split_path_info ^((?U).+\.php)(/?.+)$;和fastcgi_param PATH_INFO $fastcgi_path_info;，否则 TP 无法解析/user/list这种路径段
用 curl -I http://localhost/user/list 看响应头，如果返回 Server: nginx 且没有 X-Powered-By: ThinkPHP，基本能锁定是入口层问题。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
路由缓存没清，改了也不生效
ThinkPHP 会把路由结构缓存到 runtime/cache/ 下，尤其在生产环境 app_debug => false 时，你改了 route/route.php，它根本不会重新加载。
最简单粗暴但有效的方法：rm -rf runtime/cache/*。别只删某几个子目录，全清掉最保险。
顺手跑一下命令验证是否真加载了：
php think route:list
如果输出为空、或者没看到你刚定义的 Route::get('user/list', ...)，说明要么文件没被自动 require（比如 route/route.php 里只有注释或 return [];），要么注册时机错了（比如写在中间件里、或套在未满足的 if 判断里）。
强制路由模式下静态资源也 404
如果你开了 'url_route_must' => true，那就意味着「所有请求都必须匹配一条路由，否则直接 404」。这时候连 /static/logo.png、/favicon.ico 都会被拦下来——因为它们没在路由表里显式定义。
解决方法不是关掉强制路由，而是加白名单规则：
Route::rule('static/[:file]', 'static/:file', 'GET', ['ext' => 'png|jpg|gif|css|js']);
Route::rule('favicon.ico', 'static/favicon.ico', 'GET');或者更稳妥的做法：在 Nginx 层就拦截静态资源，不走 PHP。比如在 location / 之前加一段：
location ~* \.(?:png|jpg|gif|css|js|ico)$ {
expires 1y;
add_header Cache-Control "public, immutable";
}这样既省 PHP 开销，又绕开强制路由的坑。真正容易被忽略的是：这个配置和伪静态规则的顺序——静态资源 location 必须放在 location / 之前，否则会被兜底规则抢走。
