CakePHP 3 error.log报Js控制器不存在错误，求解决方法

嘿，我之前也碰到过一模一样的问题！其实这个错误的原因很清晰——你的请求/js/jquery.min.js没有被服务器直接处理成静态文件，反而被CakePHP的路由系统误判成了要调用JsController，但你根本没写这个控制器，所以就触发了找不到控制器的错误。至于页面和jQuery功能正常，应该是你正常的前端请求走了正确的路径，只是有一些无效请求（比如爬虫扫描、旧缓存的链接或者代码里遗留的错误引用）在偷偷触发这个日志。

下面给你几个排查和解决的步骤：

1. 先检查webroot的.htaccess配置 #

这是最常见的原因！CakePHP默认依赖.htaccess来让服务器优先处理静态资源，只有当文件/目录不存在时才交给CakePHP路由。

• 确认你的webroot目录下存在.htaccess文件，内容应该是这样的：

  RewriteEngine On
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteRule ^(.*)$ index.php [QSA,L]
  

• 如果是Apache服务器，还要确保已经启用了mod_rewrite模块。可以在phpinfo页面里搜索mod_rewrite确认，或者找服务器管理员帮忙开启。

2. 规范静态资源的引用方式 #

别硬写URL路径，用CakePHP的HtmlHelper来生成静态资源链接，这样能避免路径错误：

// 在视图模板里这么引用jQuery
echo $this->Html->script('jquery.min.js');

这个方法会自动指向webroot/js/目录下的文件，生成的URL绝对不会出错，而且会适配你的服务器重写规则。

3. 路由层面拦截静态资源请求（可选） #

如果上面的方法都试过了还是有日志，那可以在路由里加个规则，专门处理/js/这类静态资源请求，避免错误日志刷屏：
在config/routes.php的最顶部添加这段代码：

// 拦截/js/路径的请求，直接处理静态文件
$routes->connect('/js/*', function ($request, $response) {
    $filePath = WWW_ROOT . 'js' . DS . implode(DS, $request->getParam('pass'));
    if (file_exists($filePath) && is_file($filePath)) {
        return $response->withFile($filePath);
    }
    // 文件不存在时返回404，不触发错误日志
    return $response->withStatus(404)->withStringBody('File not found');
});

这样一来，所有/js/开头的请求都会被直接处理，不会再触发找不到控制器的错误了。

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