tp6资源路由404主因是请求未匹配到规则，常见于注册顺序被前置通配符路由覆盖、控制器方法名/参数名（须为$id）或命名空间不匹配、路由缓存未更新、path_info未正确传递。
TP6资源路由404，多数不是路由写错了，而是请求根本没匹配到资源规则——常见于注册顺序被覆盖、控制器签名不符、缓存未更新或PATH_INFO未正确传递。
检查资源路由是否被前置通配符路由拦截
TP6按注册顺序匹配路由，一旦前面有 Route::any('{id}', ...) 或 Route::fallback() 这类宽泛规则，resource() 就永远无法触发。
- 打开 route/app.php，确认 Route::resource('users', 'Api/User') 写在所有模糊路由之前
- 临时注释掉其他非必要路由，只保留 resource() 测试是否恢复
- 避免在同一个文件中混用闭包路由和控制器路由，尤其不要在闭包里嵌套 resource()
验证控制器命名与方法签名是否完全合规
TP6资源路由对类名、路径、方法名和参数名极其敏感，任意一项不一致都会导致 404 或 500。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 控制器文件必须位于 app/controller/Api/User.php，类名为 app\controller\Api\User
- 方法必须严格使用约定名：index、create、store、show、edit、update、destroy
- show($id)、edit($id)、update($id)、destroy($id) 的参数名必须是 $id；若用 $uid，需显式绑定：->bind(['id' => 'uid'])
- 控制器须继承 think\Controller（不是 think\BaseController）
确认路由已加载且缓存已刷新
修改 route/app.php 后，若缓存未清，新路由不会生效；开发阶段建议先关缓存再排查。
- 执行命令清除缓存：php think route:clear
- 临时关闭路由缓存：在 config/route.php 中设 'route_cache' => false
- 运行 php think route:list | grep users，确认 GET api/users 等规则存在，且 Action 列指向正确的控制器方法
- 多应用模式下，确保路由文件在 app/应用名/route/app.php，并已在 config/app.php 的 app_map 中声明
排除Web服务器层未转发请求的可能
如果访问 /api/users 返回 Nginx/Apache 原生 404（无 ThinkPHP 调试信息），说明请求压根没进框架。
- Nginx 用户检查 location / 块是否有：try_files $uri $uri/ /index.php?$query_string;
- 确认 fastcgi_param PATH_INFO $fastcgi_path_info; 已配置，且 fastcgi_split_path_info 规则未被注释
- 宝塔用户务必检查「网站目录」→「运行目录」是否设为 /public
- Apache 用户确认 .htaccess 被读取，且虚拟主机配置中 AllowOverride All 已开启
