CraftCMS 3部署问题:后台仪表盘模板未找到
CraftCMS 3 后台仪表盘404问题解决方案与排查方向
排查核心文件完整性
- 执行
composer install重新安装依赖,CraftCMS后台默认模板并不在项目根目录的templates文件夹中,而是存放在vendor/craftcms/cms/src/templates/路径下。重新安装可确保核心包文件完整,避免因文件缺失导致模板无法加载。 - 检查
vendor/craftcms/cms目录是否存在且文件未被篡改、删除,若之前手动修改过核心文件,需恢复至原始状态。
检查插件与自定义模块冲突
- 临时禁用所有第三方插件:直接修改数据库
plugins表,将所有插件的enabled字段设为0,之后刷新后台仪表盘验证是否恢复正常。 - 若禁用插件后问题解决,逐个重新启用插件,定位引发冲突的具体插件,尝试更新插件版本或替换为兼容版本。
- 排查自定义模块代码:检查是否存在监听
registerTemplates等事件的逻辑,这类代码可能覆盖了系统默认的仪表盘模板路由。
验证系统配置
- 确认
config/general.php中的cpTrigger配置值为admin,避免后台入口被修改导致路由匹配失败。 - 检查
config/routes.php是否存在自定义路由规则,若规则覆盖了admin/dashboard的默认路由,需调整或删除该规则。 - 查看数据库
settings表的siteSettings字段,确认模板路径等配置无异常。
清理缓存与重建索引
- 终端执行
./craft clear-caches/all清理全量缓存,包括模板缓存、路由缓存等。 - 执行
./craft resave/elements重建元素索引,确保后台数据索引正常。 - 若无法通过命令行操作,手动删除
storage/runtime/cache、storage/runtime/compiled_templates目录下的所有文件。
确认文件权限设置
- 确保
storage及其子目录权限为755,文件权限为644,且目录所属用户为web服务器运行用户(如www-data)。 - 检查
vendor目录权限,保证web服务器能正常读取核心模板文件。
内容的提问来源于stack exchange,提问作者Robin K
相关产品推荐
相关产品推荐

