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

加 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$ 块提前截断。

• PHP-FPM 必须透传 PATH_INFO（尤其宝塔升级 PHP 后常丢失）
  检查站点的 fastcgi_params 文件（或宝塔对应 PHP 版本的配置），确认有且仅有一行：

  fastcgi_param PATH_INFO $fastcgi_path_info;

  若被注释或重复出现，会导致 TP8.1 启动时检测失败，报 “URL pathinfo not supported”。

  

  Skill Weave Chains — 技能链路由引擎

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

  下载

  立即学习“PHP免费学习笔记（深入）”；

---

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

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

---

? 快速验证是否进框架

用 curl -I http://yoursite/admin 查响应头：

• 有 X-Powered-By: ThinkPHP → 请求进了框架，问题在路由定义或控制器匹配；
• 无该 header，且状态码是 404 → 请求被 Web 服务器拦截，未达 index.php，重点查上面三项。

基本上就这些。