Nginx默认只识别index.php，忽略admin.php是因index和fastcgi_index指令未同步改为admin.php，且rewrite规则、root指向及多应用路由注册位置均需对应调整。
为什么 admin.php 入口文件被 Nginx 忽略
ThinkPHP 的 admin 应用通常使用独立入口文件 admin.php，但 Nginx 默认只认 index.php 为 PHP 入口。如果你的配置里还保留着 index index.html index.htm index.php 和 fastcgi_index index.php，那请求根本不会落到 admin.php 上，直接 404 或 fallback 到默认应用。
常见错误现象：http://localhost/admin/login 报 404，但 http://localhost/admin.php/admin/login 能通；或者 Nginx 错误日志里反复出现 Primary script unknown。
- 必须同时修改两个地方：
index指令和fastcgi_index，都从index.php改成admin.php - 如果 admin 应用是多应用结构（如
app/admin/），root必须指向项目根目录下的public，不是项目根目录本身 - rewrite 规则也要同步改：原
rewrite ^(.*)$ /index.php?s=/$1 last;得换成rewrite ^(.*)$ /admin.php?s=/$1 last; - 改完记得
nginx -t && nginx -s reload，否则配置不生效
VS Code 内置 PHP 服务器不加载路由文件
用 VS Code 的 launch.json 启动内置服务器时，php -S 默认只转发静态资源和 index.php，不会自动加载 ThinkPHP 的路由分发逻辑——尤其是带点号的二级路由（如 /api/auth.admin/info）会直接 404。
根本原因：内置服务器没执行 public/router.php 这个 ThinkPHP 提供的路由兜底脚本。
立即学习“PHP免费学习笔记（深入）”；
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 在
launch.json的runtimeArgs中补上"${cwd}/public/router.php"，顺序不能错：必须放在-t参数之后、其他参数之前 - 完整参数示例：
["-S", "localhost:8000", "-t", "${cwd}/public", "${cwd}/public/router.php"] - 别用兼容模式拼
?s=/xxx，那只是绕过问题，不是解决路由加载逻辑 - 确认
public/router.php文件真实存在且可读——TP6/TP8 都自带这个文件，TP5 可能需要手动创建
多应用模式下 admin 路由注册位置错了
TP6/TP8 多应用模式中，admin 是一个独立应用，它的路由定义**不能**写在项目根目录的 route/app.php 里，否则框架启动时压根不加载。
典型表现：访问 /admin/login 时路由系统完全没反应，连“未定义”提示都没有，直接走默认应用或报错 当前访问路由未定义或不匹配。
- 正确路径是：
app/admin/route/app.php（TP6）或app/admin/route/route.php（TP8） - 检查
config/app.php中是否启用多应用：'app_multi' => true，且'default_app' => 'index'不影响 admin 的独立加载 - 如果用了
Route::import()，确保导入路径是相对 admin 应用根目录的，比如import('route/api')对应的是app/admin/route/api.php - 别在
app/common.php或中间件里动态注册 admin 路由——此时应用上下文还没切换过去
URL 大小写和隐式推导不一致
Linux 服务器上 /Admin/Login 和 /admin/login 是两个不同路径，而 ThinkPHP 隐式路由依赖控制器文件名、类名、方法名三者严格匹配。一旦错位，就 404，且错误信息不提示具体哪一环断了。
例如你访问 /admin/login，框架会去找 app/admin/controller/Admin.php 里的 login 方法，但如果实际文件叫 admin.php（小写）、类名是 AdminController、方法是 Login，全部对不上。
- 统一用 PascalCase 命名控制器文件：
Admin.php，类名Admin，方法名小驼峰login - 检查
config/app.php中'url_convert' => true是否开启（默认开），它会把admin_login自动转成adminLogin；关掉后必须严格按方法名访问 - 显式路由比隐式更可靠：
Route::get('admin/login', 'admin.controller.Admin@login')绕过所有路径推导 - 清空
runtime/route缓存再试，旧缓存可能记着错误的映射
真正卡住人的地方往往不是某条配置写错了，而是多个环节协同失效：Nginx 没把请求交到 admin.php，admin.php 又没加载对的路由文件，路由文件里又因大小写或路径错位找不到控制器——三层漏斗，漏掉一层就断掉。
