控制器方法名大小写不匹配、未声明为public、路由未正确绑定、缓存未清除是导致404的四大主因，需逐项排查。
控制器方法名大小写不匹配导致404
PHP框架（如 Laravel、ThinkPHP、CodeIgniter）默认对控制器方法名区分大小写。如果你在路由中访问 index，但实际定义的是 Index 或 INDEX，绝大多数框架会直接返回 404 —— 它根本不会尝试匹配。
- 检查控制器内方法声明是否全小写（Laravel 要求小驼峰，如
showUser；ThinkPHP 6 默认要求小写加下划线，如user_list） - 确认 URL 中调用的方法名与方法定义**逐字符一致**，包括下划线、驼峰、连字符
- Laravel 的
Route::get('/user', [UserController::class, 'show'])中的'show'必须对应控制器里public function show()，不能是public function Show()
方法未声明为 public 导致 404
很多新手把控制器方法写成 private 或 protected，框架无法调用，就跳过该方法，最终找不到可执行逻辑而报 404。
- 所有可被路由调用的控制器方法必须是
public - IDE 或 PHPStan 可能不报错，但运行时一定失败
- 检查方法前是否有
public关键字，尤其复制粘贴旧代码时容易漏掉
路由未正确绑定到该方法
即使方法名拼写正确、权限正确，如果路由没指向它，照样 404。常见于手动注册路由或使用资源路由时配置偏差。
- Laravel 使用
php artisan route:list查看实际注册的路由，确认目标 URI 对应的Action列是否为你的控制器@方法 - ThinkPHP 检查
route/app.php是否有显式绑定，或是否启用了「自动解析」但控制器/方法命名不符合约定 - CodeIgniter 4 注意
$routes->add('user', 'User::profile')中的User::profile是否拼写准确，类名大小写也要匹配文件名
缓存未清除导致旧路由规则生效
修改控制器方法名或路由配置后，框架常缓存路由表，你改了代码但请求仍走老路径，结果还是 404。
立即学习“PHP免费学习笔记（深入）”；
- Laravel 执行
php artisan route:clear和php artisan config:clear - ThinkPHP 运行
php think clear或手动删掉runtime/cache/下所有文件 - CodeIgniter 4 清空
writable/cache/目录内容 - 别忘了 Web 服务器（如 Nginx）或代理层（如 Cloudflare）也可能缓存了 404 响应，临时关掉测试
php artisan route:list | grep user
真正卡住的地方往往不是“怎么写”，而是“你以为它在调这个方法，其实它压根没看到”。多看一遍 route:list 输出，比反复改方法名更有效。
