WordPress插件中MySQL UPDATE查询执行报错问题求解

你遇到的Uncaught Error: Call to a member function query() on null报错，核心原因是执行数据库操作时，WordPress的全局数据库操作对象$wpdb尚未完成初始化，处于null状态，可按以下步骤排查解决：

• 检查代码执行时机
  不要在WordPress核心初始化完成前调用数据库操作，也不要把这段逻辑写在脱离WordPress核心的独立PHP文件中。建议将数据库操作挂载到WordPress的init及之后的钩子中执行，示例代码如下：

  add_action('init', 'custom_update_table_data');
  function custom_update_table_data() {
      global $wpdb;
      // 后续数据库操作逻辑写在这里
  }
  

  如果是处理Ajax请求，必须使用WordPress官方的wp_ajax_*系列钩子处理逻辑，不要自定义独立接口文件，避免WordPress核心未加载导致$wpdb不存在。
• 修正$wpdb->prepare的错误用法
  你当前的写法没有正确使用占位符，不仅没有起到防注入的作用，也可能因为变量值包含特殊字符导致SQL执行错误。正确用法是SQL语句中用%s对应字符串类型变量、%d对应整数类型变量，变量放在prepare方法的后续参数中传入，同时建议表名拼接WordPress表前缀适配不同站点配置，修正后的代码如下：

  global $wpdb;
  $table_name = $wpdb->prefix . 'myTable';
  $wpdb->query(
      $wpdb->prepare(
          "UPDATE {$table_name} SET name = %s WHERE id = %d",
          $name,
          $idTable
      )
  );
  

• 检查全局变量声明位置
  如果你的代码写在类方法中，必须在方法内部第一行声明global $wpdb，不要直接在类属性位置声明全局变量，示例如下：

  class CustomPlugin {
      public function updateTable() {
          global $wpdb; // 全局变量必须声明在方法内部
          // 执行数据库操作
      }
  }
  

内容的提问来源于stack exchange，提问作者Clément Gaudinière