CakePHP4启用登录认证后出现404资源加载失败问题求助

• 核对三层.htaccess文件完整性
  CakePHP 4默认在项目根目录、src目录、webroot目录下各有一份重写规则文件，很多人调整项目结构、手动修改重写规则时容易改坏webroot目录下的核心重写规则——这份规则负责把所有不存在对应实体文件的请求统一转发到入口文件index.php，规则缺失哪怕开了mod_rewrite.so模块也会触发404。
• 检查认证组件的拦截配置
  配置Authentication认证组件时如果没加白名单，组件会默认拦截所有请求，包括css、js、图片这类静态资源请求，资源请求被拦截后找不到对应控制器处理就会返回404。可以先直接访问报错404的资源完整路径做验证：如果访问资源路径自动跳登录页或者直接返回404，就是拦截规则的问题，优先把静态资源路径加入认证豁免列表，或者在中间件加载逻辑里直接跳过真实存在的资源路径的认证校验。
• 核对WAMP虚拟主机配置
  WAMP环境下配置虚拟主机时最常见的错误是把DocumentRoot指向项目根目录，而不是CakePHP要求的webroot目录，会导致路由基准路径计算错误，登录后的跳转路径、资源路径拼接异常触发404。同时要确认虚拟主机对应目录下配置了AllowOverride All，否则目录下的.htaccess规则不会生效，正确配置参考：

  <VirtualHost *:80>
      ServerName 你本地配置的项目域名
      DocumentRoot "d:/wamp64/www/你的项目目录/webroot"
      <Directory "d:/wamp64/www/你的项目目录/webroot">
          AllowOverride All
          Require all granted
          Options Indexes FollowSymLinks
      </Directory>
  </VirtualHost>
  

• 排查路由优先级冲突
  如果登录相关路由配置时把通配符泛匹配规则（比如/{controller}/{action}/*）放在了路由列表最前面，会把静态资源路径误匹配成控制器请求，找不到对应方法就会抛404，把泛匹配规则移到所有具体路由的最末尾即可。
• 清理项目缓存
  所有配置修改完成后，在项目根目录执行命令bin/cake cache clear_all清空CakePHP的路由缓存、配置缓存，避免旧缓存导致新配置不生效。

快速定位技巧：暂时注释掉认证中间件的加载逻辑，刷新页面看资源是否能正常加载，如果恢复正常直接定位为认证白名单配置问题；如果还是404，优先排查虚拟主机配置和.htaccess规则。

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