Devel模块查询日志在自定义主题显示异常的技术求助

先给你拆解Devel模块查询日志的输出逻辑，这样你就能明白为什么自定义主题下会出现部分页面不显示的情况：

核心输出流程 #

Devel的查询日志（Query Log）本质是通过后端注入+主题渲染的方式呈现的，分两个主流Drupal版本场景看：

针对Drupal 7 #

1. 模块会在每一次数据库查询执行时记录详情，然后通过devel_page_alter()钩子，把生成好的日志HTML内容添加到页面的$page['page_bottom']区域里。
2. 最终能不能显示，完全依赖你的主题模板（比如page.tpl.php）是否渲染了$page['page_bottom']这个区域——也就是模板里有没有print render($page['page_bottom']);这段代码。

针对Drupal 8/9/10 #

1. 模块通过专门的服务收集查询日志，再用devel_page_attachments()钩子把日志数据以JS变量的形式附加到页面，同时加载对应的样式和脚本文件。
2. 前端JS会自动在页面底部渲染出日志UI，但前提是主题的模板（比如page.html.twig）正确渲染了page_bottom区域（也就是{{ page.page_bottom }}这段代码），并且页面的JS执行环境正常。

针对你的问题（首页/管理页不显示，内页正常）的排查方向 #

你已经检查了通用的page.tpl.php/html.tpl.php，那大概率是特定页面的模板差异或者主题的钩子修改导致的，给你几个具体的排查点：

• 检查特定页面的模板文件：自定义主题很可能为首页单独做了模板（比如page--front.tpl.php或page--front.html.twig），或者给管理页做了专属模板（page--admin.tpl.php/page--admin.html.twig）。打开这些文件看看，有没有遗漏page_bottom区域的渲染代码——比如Drupal7里的print render($page['page_bottom']);，或者Drupal8+里的{{ page.page_bottom }}。这是最常见的原因。
• 检查主题的钩子修改：看看主题的template.php（Drupal7）或者.theme文件（Drupal8+）里，有没有用hook_page_alter()或者hook_preprocess_page()做过逻辑判断，比如在首页或管理页的时候清空了$page['page_bottom']里的内容，或者移除了Devel的日志元素。
• 核对Devel的配置：进入后台的Devel设置页（admin/config/development/devel），确认「显示查询日志」是勾选状态，并且没有设置页面过滤规则（比如只允许在特定路径显示，或者排除了首页/管理页的路径）。
• 前端源码排查：用浏览器开发者工具查看页面源码，如果能找到#devel-query-log的容器或者Drupal.devel.queryLog的JS变量，说明后端已经注入了日志，只是被CSS隐藏了；如果完全找不到相关代码，那就是后端没把日志加到页面里，回到前面的排查点找原因。

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