WordPress虚拟页面PHP 8.0报错：尝试读取null的post_type属性

问题根源 #

你的代码在WordPress完成主查询初始化前就执行了虚拟页面逻辑，此时全局变量$post和$wp_query还未被赋值。PHP8.0对null对象的属性访问会抛出警告（PHP7.x及以下仅为通知，所以之前没暴露）。核心是要调整虚拟页面的执行时机，确保在WordPress主查询完成后再处理，同时手动补全必要的查询属性。

修复步骤 #

1. 正确注册重写规则
   重写规则必须在init钩子上注册，确保WordPress重写系统已初始化：

   add_action('init', 'register_virtual_page_rewrite');
   function register_virtual_page_rewrite() {
       // 示例：匹配 /my-api-data/{id} 格式的URL
       add_rewrite_rule(
           '^my-api-data/([^/]+)/?$',
           'index.php?virtual_api_id=$matches[1]',
           'top'
       );
   }
   

2. 注册自定义Query Var
   把你的自定义query变量加入允许列表，让WordPress识别它：

   add_filter('query_vars', 'add_virtual_query_var');
   function add_virtual_query_var($vars) {
       $vars[] = 'virtual_api_id';
       return $vars;
   }
   

3. 在正确钩子触发虚拟页面
   使用template_redirect钩子（主查询完成后触发），同时手动补全$wp_query和$post的必要属性，避免null警告：

   add_action('template_redirect', 'render_virtual_api_page');
   function render_virtual_api_page() {
       global $wp_query, $post;
   
       // 检查是否匹配自定义query变量
       $api_id = get_query_var('virtual_api_id');
       if (!$api_id) return;
   
       // 手动设置查询属性，标记为页面类型
       $wp_query->is_page = true;
       $wp_query->is_singular = true;
       $wp_query->is_home = false;
       $wp_query->post_type = 'page'; // 直接赋值post_type，解决警告
   
       // 构造空的WP_Post对象，避免其他代码访问$post时报错
       $post = new stdClass();
       $post->ID = 0;
       $post->post_type = 'page';
       $post->post_status = 'publish';
       $post->post_title = 'API数据页面'; // 可自定义页面标题
   
       // 从API获取数据并输出
       $api_data = fetch_data_from_api($api_id); // 替换成你的API调用函数
       if (!$api_data) {
           status_header(404);
           echo '<h1>数据不存在</h1>';
           exit;
       }
   
       // 输出页面内容
       get_header();
       echo '<div class="entry-content">';
       echo '<h1>API数据详情</h1>';
       echo '<pre>' . print_r($api_data, true) . '</pre>';
       echo '</div>';
       get_footer();
   
       exit; // 终止WordPress后续流程，避免加载默认模板
   }
   

4. 刷新重写规则
   完成代码修改后，登录WordPress后台，进入「设置」→「固定链接」，直接点击「保存更改」，无需修改任何设置，让WordPress更新重写规则到数据库。

关键说明 #

• 不要在plugins_loaded或wp钩子之前处理虚拟页面，这些时机下主查询还未初始化，$wp_query和$post都是null。
• 手动设置$wp_query->post_type和构造$post对象，是为了兼容WordPress主题和插件中可能存在的$post->post_type访问逻辑，从根源上消除警告。

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