ThinkPHP 8.1.0路由404为何加index.php能访问-ThinkPHP-PHP中文网

加 index.php 能访问但去掉 404，说明请求未进入 thinkphp 框架，根本原因是 web 服务器伪静态配置错误：nginx root 未指向项目根目录且运行目录未设为 /public、伪静态规则未启用或内容错误、php-fpm 未透传 path_info。

thinkphp 8.1.0路由404为何加index.php能访问

加 index.php 能访问，但去掉就 404，说明请求根本没进框架入口——不是代码或路由写错了，而是 Web 服务器（Nginx 或 Apache）没把 /xxx 这类路径转发给 public/index.php 处理。

核心问题就一个：伪静态规则未生效或配置错误，导致 URL 被当作静态资源或不存在路径直接返回 404，压根没走到 ThinkPHP。

✅ 必查三件事（按优先级排序）

Nginx 的 root 必须指向项目根目录，且「运行目录」必须设为 /public
宝塔用户：网站设置 → 网站目录 → 运行目录填 /public（开头带斜杠），保存并重载 Nginx。
若 root 错设在 public/ 内部，或仍指向项目顶层（含 app/ config/），则 try_files 匹配不到 index.php，CSS/JS 也全 404。
伪静态规则必须启用，且内容正确
宝塔 → 网站设置 → 伪静态 → 下拉选「thinkphp」→ 保存 + 重载。
若手动填写，只留这一行即可（其他 if、rewrite、fastcgi_split_path_info 全删）：
```
location / {
    try_files $uri $uri/ /index.php?$query_string;
}
```
⚠️ 注意：此规则必须放在 server 块内，且不能被其他 location ~ \.php$ 块提前截断。

Skill Weave Chains — 技能链路由引擎
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载
PHP-FPM 必须透传 PATH_INFO（尤其宝塔升级 PHP 后常丢失）
检查站点的 fastcgi_params 文件（或宝塔对应 PHP 版本的配置），确认有且仅有一行：
```
fastcgi_param PATH_INFO $fastcgi_path_info;
```
若被注释或重复出现，会导致 TP8.1 启动时检测失败，报 “URL pathinfo not supported”。

❌ 常见干扰项（务必清理）

删除所有 fastcgi_split_path_info 相关配置 —— ThinkPHP 不需要它，留着反而让 $_SERVER['PATH_INFO'] 变空或错乱。
关闭宝塔的「防跨站攻击（open_basedir）」—— 否则 runtime/ 目录无法写入，日志不生成，错误提示只剩 “Permission denied”。
.env 中确保 APP_DEBUG=true（调试阶段），否则 404 无任何提示；上线前务必关掉。
执行 php think route:clear 清除路由缓存 —— 修改过路由文件后不清理，旧规则仍生效。