更新functions.php后，如何修复WordPress自定义主题的500内部服务器错误？

500内部错误大多是PHP语法问题或者代码逻辑冲突，按以下步骤排查：

• 开启调试模式定位错误
  登录主机的文件管理器或FTP，找到根目录的wp-config.php，修改以下配置：

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

  错误日志会写入wp-content/debug.log，打开日志就能看到具体的错误信息（比如哪一行的语法错误、未定义的函数）。

• 检查functions.php的语法与修改内容
  重点看你最近更新的代码段：

  • 有没有遗漏分号、括号不匹配（比如函数的{}没闭合，if语句的括号漏写）
  • 是不是调用了不存在的函数、类，或者使用了PHP版本不支持的语法（比如用了PHP8的特性但主机是PHP7.2）
  • 有没有不小心删除了原有代码的关键部分（比如主题的核心函数）

• 逐步排查出错代码

  • 如果有修改前的备份，先替换回旧的functions.php，确认站点正常后，再逐段添加新代码，每加一段刷新页面，找到触发错误的代码块。
  • 没有备份的话，把当前functions.php重命名为functions-old.php，WordPress会自动 fallback 到主题默认的基础函数文件（子主题的话会用父主题的functions.php），站点恢复后再重新编写正确的代码。

• 排查其他可能原因

  • 增加PHP内存限制：在wp-config.php里添加define('WP_MEMORY_LIMIT', '256M');，避免因内存不足导致错误。
  • 检查文件权限：确保functions.php的权限是644，所在主题文件夹权限为755，权限异常会导致服务器无法读取文件。

内容的提问来源于stack exchange，提问作者M EHSAAN UR REHMAN SHAHEEN