WooCommerce首页输出指定商品页及短代码调用异常问题求助

方案一：后台可视化配置（无代码，最稳定） #

这是最稳妥的实现方式，不需要修改任何代码：

1. 新建一个独立页面，在Gutenberg编辑器中填入短代码[product_page id=815]后发布
2. 进入 WordPress 后台 → 设置 → 阅读，将「首页显示」设置为「静态页面」，首页下拉选择你刚创建的这个页面，保存设置即可。
   该方案所有WooCommerce自带的JS资源、逻辑都会正常加载，不需要额外处理。

方案二：代码修改主查询（性能最优，无模板修改） #

WordPress首页路由优先级高于自定义重写规则，因此add_rewrite_rule对根路径不生效，可以通过pre_get_posts钩子直接修改首页主查询的参数，让首页直接返回指定商品：

add_action( 'pre_get_posts', function( $query ) {
    // 只对前台首页主查询生效
    if ( $query->is_main_query() && $query->is_home() && ! is_admin() ) {
        $query->set( 'post_type', 'product' );
        $query->set( 'p', 815 ); // 替换为你的商品ID
        $query->set( 'posts_per_page', 1 );
        // 标记为单页，避免分页逻辑
        $query->is_singular = 1;
        $query->is_home = 0;
        $query->is_archive = 0;
    }
} );

添加代码后刷新重写规则即可，该方案完全适配WooCommerce原生逻辑，PayPal、PhotoSwipe等资源都会自动入队加载。

方案三：页面模板手动调用短代码适配 #

你手动调用短代码缺少资源的原因是：WooCommerce的[product_page]短代码只有在主查询的the_content解析流程中被执行时，才会自动入队所需JS资源，单独调用do_shortcode时不会触发资源入队逻辑。
在你的模板文件page-certainproductpage.php中调整代码即可解决：

if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

// 提前加载指定商品数据，触发WooCommerce资源入队
$product_id = 815;
global $post, $product;
$post = get_post( $product_id );
$product = wc_get_product( $product_id );
wc_enqueue_scripts();

get_header( 'shop' );

echo do_shortcode("[product_page id='815']");

get_footer( 'shop' );

额外说明：过滤器注入死循环原因 #

你之前通过the_content过滤器注入短代码触发超时，不是WooCommerce的bug，是逻辑递归导致的：[product_page]短代码内部会调用the_content过滤器解析商品本身的内容，你在the_content钩子中返回带该短代码的内容，会触发无限循环解析，最终导致执行时间超限。

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