CakePHP 3访问/blog路由触发Missing Controller Exception问题排查

先别慌，这个问题大概率不是框架Bug，咱们一步步排查：

1. 优先清理路由缓存 #

CakePHP会自动缓存路由规则，如果你之前修改过路由但没清理缓存，旧的缓存规则可能还在生效。执行下面的命令清空所有缓存：

bin/cake cache clear_all

之后再访问/blog试试，很多时候这个操作就能解决问题。

2. 验证路由匹配是否正确 #

运行路由调试命令，查看当前所有生效的路由规则，确认你的/blog路由是否正确指向了Pages控制器：

bin/cake routes

在输出里找/blog对应的条目，正常应该显示controller: Pages, action: blog。如果没找到这条路由，说明你的路由代码没被正确加载：

• 检查是不是写在了config/routes.php文件里
• 确认路由定义的位置：CakePHP路由是从上到下匹配的，如果你的/blog路由写在$routes->fallbacks(DashedRoute::class);之后，可能会被默认路由拦截，把它移到fallbacks代码之前试试。

3. 检查PagesController的细节 #

• 确认PagesController.php文件放在src/Controller/目录下，文件名首字母大写没有错误
• 检查blog方法的拼写，有没有笔误（比如写成blod），并且确保方法是public权限（你已经写了，这点没问题）
• 注意方法里的代码：$this->viewBuilder()->setlayout('frontend');中setLayout是驼峰写法，正确的应该是setLayout（大写L），虽然CakePHP可能兼容小写，但规范写法是驼峰，改成$this->viewBuilder()->setLayout('frontend');试试，避免因为方法名错误导致控制器报错被误判为找不到控制器。

4. 排除其他干扰因素 #

• 有没有安装路由相关的插件？如果有，暂时禁用插件再测试，看是不是插件路由冲突
• 检查.htaccess文件（Apache环境）或者Nginx配置，确保请求正确转发到CakePHP的入口文件webroot/index.php，如果URL重写有问题，也可能导致路由解析错误

如果以上步骤都排查过还是有问题，再考虑框架版本的问题，但CakePHP 3.7.4是比较稳定的版本，没听说过这类路由Bug，大概率还是配置或缓存的问题。

内容的提问来源于stack exchange，提问作者Kasun Wijesekara