使用Timber（WordPress）时自定义Twig 404页面空白问题排查

看起来你遇到的问题是Timber没有接管WordPress默认的404错误处理流程——你手动加的/404路由能正常加载模板，但当真正的404错误（比如访问不存在的页面、无效URL）触发时，WordPress没有调用你的Timber模板，导致空白页。我之前用Timber做项目时也踩过这个坑，给你几个具体的解决步骤：

默认情况下，WordPress会在触发404时加载主题根目录下的404.php。如果你的主题里没有这个文件，或者文件里缺少Timber的核心逻辑，就会出现空白页。

正确的404.php结构应该是这样的：

<?php
/**
 * The template for displaying 404 pages (not found)
 *
 * @package YourThemeName
 */

// 初始化Timber上下文
$context = Timber::context();
// 创建空的Post对象（因为404页面没有对应的文章）
$timber_post = new Timber\Post();
$context['post'] = $timber_post;

// 加载你的自定义Twig模板，替换成你实际的路径
Timber::render( 'views/404.twig', $context );

注意：要把views/404.twig换成你项目中实际的Twig模板路径，确保这个文件存在且内容正常（比如有基础的HTML结构）。

你在functions.php里添加的Routes::map('/404', ...)是创建了一个静态页面路由，它只在用户主动访问/404时生效，但和WordPress原生的404错误处理完全是两回事。

• 如果你的目标是让所有404错误都用同一个Twig模板，那这个路由完全多余，直接删掉即可。
• 如果需要保留/404作为一个可访问的静态页面，那也要确保原生404流程不受影响（即保留正确的404.php）。

有时候空白页可能是因为WordPress没有正确识别404状态，比如缓存插件、SEO插件或者服务器配置干扰了判断。可以做个快速测试：

• 临时切换到WordPress默认主题（比如Twenty Twenty-Four），访问一个不存在的页面，看是否能显示默认的404页面。
  • 如果不能，说明是WordPress本身的404配置有问题，需要检查服务器的重写规则（比如Apache的.htaccess或Nginx的rewrite配置）。
  • 如果默认主题能正常显示404，那问题肯定出在你的Timber主题的404处理逻辑上，回到第一步重新检查404.php的代码。

如果还是空白，可以开启WordPress的调试模式，看看是否有PHP错误：
在wp-config.php中添加或修改以下代码：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', true );

这样如果有Timber模板找不到、函数调用错误等问题，就会直接显示出来，帮你快速定位根源。

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