如何调试WordPress升级PHP8.1时的「TypeError: string/float不支持操作数类型」

• 开启WordPress调试模式，锁定错误具体位置
  修改网站根目录的wp-config.php文件，添加或修改以下配置：

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

  访问出错页面后，查看wp-content/debug.log文件，里面会明确记录错误触发的文件名和行号，这是定位问题的核心依据。

• 定位除法运算代码
  根据日志里的文件路径和行号，找到对应的代码行，重点看使用/运算符的地方。PHP8.x对类型严格性提升，7.4中会自动隐式转换的混合类型运算（比如字符串转数字），在8.x里会直接抛出错误。常见场景包括：

  • 直接用自定义字段（get_post_meta()）、主题选项（get_option()）的返回值做除法，这些值可能是空字符串、带非数字字符的字符串，而非预期的数字类型。

• 对可疑变量做类型校验与转换
  找到可疑变量后，先确认它的类型和值：可以在代码中添加error_log(var_export($变量名, true));，然后查看debug.log里的输出。
  确认问题后，强制转换类型或添加判断再运算，示例：

  // 先判断是否为有效数字，再转换为浮点型运算
  if (is_numeric($price)) {
      $discounted_price = (float)$price / 1.5;
  } else {
      $discounted_price = 0; // 设一个默认值避免报错
  }
  

• 用排除法缩小范围
  因为仅页面主体崩溃，导航正常，问题大概率出在渲染主体内容的模板文件（如index.php、single.php、page.php）或functions.php中的核心函数。可以临时把这些文件替换为WordPress默认主题的对应文件，若替换后恢复正常，就说明原文件存在问题，再逐段排查原文件代码。

• 检查函数返回值的类型变化
  PHP8.x部分函数的返回值类型与7.4不同，比如某些WordPress函数在选项/字段不存在时返回false或空字符串，7.4会自动转成0参与运算，8.x则会触发类型错误。排查时留意这类场景，确保变量是预期的数字类型再进行运算。

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