You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.28 20:12:14