更新母主题后子主题故障致网站崩溃求助

WordPress网站更新母主题后，激活子主题就出现白屏死机（White Screen of Death）。已通过修改子主题名称切换到默认主题恢复网站，但未查明子主题崩溃原因，怀疑是子主题的functions.php存在问题，不敢轻易修改，附上该文件代码。

你提供的子主题functions.php完全复制了母主题（Betheme）的核心初始化代码，这是错误的子主题写法：

• 子主题的核心作用是覆盖/扩展母主题功能，不需要重复加载母主题的所有核心文件（比如主题选项、构建器、自定义文章类型等），母主题本身会自动加载这些内容
• 重复加载会导致函数重复定义、路径冲突、版本不匹配（更新后的母主题代码和子主题里旧的母主题代码冲突），直接触发PHP致命错误，引发白屏
• 代码中使用get_template_directory()（指向母主题路径）加载文件，但子主题里重复加载这些文件时，会和母主题的加载逻辑冲突

1. 临时开启调试模式定位错误（可选）
   在网站根目录的wp-config.php中添加以下代码，激活子主题后会显示具体错误信息，方便精准排查：

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

   排查完成后记得改回WP_DEBUG false关闭调试。

2. 重构子主题functions.php
   删掉所有母主题核心加载代码，只保留你需要的自定义逻辑。正确的子主题functions.php应该只包含你自己添加的功能，而非复制母主题的全部初始化代码。

3. 修改后的子主题functions.php示例

   <?php
   // 子主题版本定义（如果需要自定义版本）
   define('MFN_THEME_VERSION', '26.4.0.8');
   
   // 自定义过滤器
   add_filter('widget_text', 'do_shortcode');
   add_filter('the_excerpt', 'shortcode_unautop');
   add_filter('the_excerpt', 'do_shortcode');
   
   // 自定义白标签设置
   defined('WHITE_LABEL') or define('WHITE_LABEL', false);
   
   // 加载子主题翻译文件（如果有）
   load_theme_textdomain('betheme', get_stylesheet_directory() .'/languages');
   load_theme_textdomain('mfn-opts', get_stylesheet_directory() .'/languages');
   
   // 这里添加你的其他自定义代码，比如自定义函数、钩子等
   

4. 测试激活
   将修改后的functions.php上传到子主题目录，重新激活子主题验证是否恢复正常。

• 子主题中如果需要引用母主题的文件，使用get_template_directory()；引用子主题自己的文件，使用get_stylesheet_directory()
• 不要在子主题中重复定义母主题已有的函数，如需修改母主题函数，优先使用钩子（filter/action），或者使用function_exists()判断后再定义
• 后续母主题更新时，子主题只需要维护自己的自定义代码即可，无需同步母主题的核心代码

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