Function add_theme_support('post-formats')调用错误求助：Timber相关多站点模板插件冲突问题排查

Hey Jonathan，我完全理解这个错误突然出现在生产站点有多闹心，尤其是你们没有内部开发团队、对编码不太熟悉的情况下。咱们一步步来，先稳住生产站，再排查根源：

1. 先紧急隐藏生产站的错误提示 #

现在头部的错误已经影响用户体验，先把它关掉：

• 找到网站根目录下的wp-config.php文件，修改以下两行配置：

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

  这样生产站点就不会再显示错误提示了，先把眼前的问题解决。

2. 排查插件冲突（最可能的诱因） #

你怀疑是新插件导致的冲突，这个方向非常对，咱们这么验证：

• 找一个测试站点（绝对别直接操作生产站），先禁用所有插件，然后逐个重新启用，每启用一个就检查是否出现add_theme_support('post-formats')的错误，找到那个触发问题的插件。
• 注意多站点的特殊性：要区分是「网络激活」的插件还是「单个站点激活」的插件，网络级别的插件冲突会影响所有站点，这也能解释为什么没修改的站点也出问题。

3. 检查主题与Timber的兼容性 #

错误标记指向Timber，大概率是主题调用add_theme_support的方式有问题，或者Timber版本不兼容：

• 打开主题的functions.php文件，找到调用add_theme_support('post-formats')的代码，确保它是挂在after_setup_theme钩子下的，正确的写法应该是这样：

  add_action('after_setup_theme', 'my_custom_theme_setup');
  function my_custom_theme_setup() {
      // 这里的格式数组可以根据你的需求调整
      add_theme_support('post-formats', array('aside', 'gallery', 'link', 'quote'));
  }
  

• 确认Timber的版本：如果最近更新过Timber，可能是新版本和主题不兼容，可以尝试回退到之前能正常工作的版本（先在测试站测试）。

4. 多站点全局配置排查 #

因为错误影响所有模板站点，哪怕没修改的，要检查网络级别的配置：

• 看看「网络管理」里的插件是否有全局激活的可疑插件，或者wp-content/mu-plugins目录下的必须插件是否有问题（这些插件会在所有站点生效）。
• 确认所有站点使用的是同一个主题模板，有没有某个站点的子主题自定义代码意外影响了全局？

5. 修复Timber对文章格式的支持 #

如果以上都没解决，可以试试给Timber的文章格式支持加个过滤钩子，在主题的functions.php里添加：

add_filter('timber/post/formats', 'custom_timber_post_formats');
function custom_timber_post_formats($default_formats) {
    // 这里的格式列表和你主题需要的保持一致
    return array_merge($default_formats, array('aside', 'gallery', 'link'));
}

如果在排查过程中能拿到更完整的错误信息（比如PHP错误日志里的详细内容），可以补充出来，这样能更快定位问题。

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