Method not exist 错误主因是路由未匹配到控制器方法，而非方法真实不存在；常见于资源路由未配HTTP方法、Route::rule()漏写回调、下划线方法名未开启url_convert、路由规则冲突或缓存未更新。
为什么访问控制器方法会报 Method not exist
ThinkPHP 报这个错，**不是方法真不存在，而是路由没走到你写的控制器方法里**。常见于：定义了资源路由或 RESTful 路由后，手动加了同名方法但没配对 HTTP 方法；或者用了 Route::rule() 却漏写了闭包/数组方式的完整回调；还有更隐蔽的情况——控制器方法名带下划线但没开启 url_convert（默认关闭）。
关键判断点：Method not exist: app\controller\IndexController->test_action 这类提示里，如果方法名含下划线，大概率是命名风格和路由解析不匹配。
- ThinkPHP 6 默认禁用下划线转驼峰，
test_action不会自动映射到testAction - 资源路由（
Route::resource()）只注册预设的 7 个方法（index/create/save等），额外加的方法必须显式绑定 - 使用
Route::any()或Route::miss()时，若没返回响应，也会退到“方法不存在”逻辑
Route::get() 和 Route::rule() 的权限控制差异
很多人以为只要在控制器里加 __construct() 做权限检查就稳了，其实路由层就能拦住——而且更早、更干净。
-
Route::get('admin/profile', 'Admin/Profile/index')->middleware('auth')：中间件在路由匹配后、控制器执行前运行，适合统一鉴权 -
Route::rule('api/user/:id', 'Api/User/read', 'GET', ['auth' => true])：这种写法不会触发中间件，['auth' => true]是无效配置，纯属误导 - 控制器内手动
if (!session('?admin_id')) throw new HttpException(403);是兜底手段，但请求已进应用层，浪费资源
真正可控的方式只有两种：用中间件链（推荐），或在路由闭包里直接返回（适合简单判断）：
立即学习“PHP免费学习笔记（深入）”；
Route::get('manage/log', function () {
if (!auth_check()) {
return json(['code' => 403, 'msg' => 'forbidden']);
}
return \app\controller\Manage::log();
});
控制器方法被忽略的三个典型路由冲突场景
不是代码写错了，是路由规则“抢跑”了你的方法。
- 全局
Route::any(':id', 'Index/read')放在最前面，会导致所有短路径（如/about）全被它吃掉，后面定义的Route::get('about', 'Index/about')根本不生效 - 模块路由开启后，
route_config.php里的'default_module' => 'home'会让/user/login实际去查app\home\controller\User，而不是你预期的app\index\controller\User - 使用
Route::import()加载外部路由文件时，若文件里有return [];但数组为空，ThinkPHP 会静默跳过，不报错也不注册任何规则
调试 Method not exist 的实际步骤
别急着改控制器，先确认请求到底被哪条路由接住了。
- 打开
app/middleware/Trace.php（或临时加一个中间件），在handle()里打日志：trace('route_info', $request->routeInfo()); - 看日志里
['name']字段是否为你期望的控制器/方法；如果是__call或空数组，说明路由没匹配上 - 执行
php think route:list，检查输出中是否有目标路由，注意 Method 列是否匹配（比如你用 POST 访问却只注册了 GET） - 临时把控制器方法改成
public function index()并走默认路由，确认是不是命名问题——能通就说明是路由解析或方法名风格问题
最常被忽略的是：开发环境开了调试模式，但生产环境关了，导致路由缓存没刷新，php think clear:route 必须在部署后跑一次。
