WordPress插件命名空间下扩展WC_Product类提示未找到如何解决？

错误根源 #

• 核心问题是钩子触发时机错误：init 钩子默认执行优先级为10，此时WooCommerce核心类库尚未完成加载，自然找不到WC_Product类
• 你使用的通用自动加载器会在插件初始化阶段就尝试加载自定义产品类型类，此时WooCommerce还未启动，类加载直接失败
• 早期代码存在语法问题：你最初写的构造方法未定义$product参数，调用父类构造时会抛出参数缺失错误

解决方案 #

步骤1：更换正确的加载钩子 #

使用WooCommerce官方指定的woocommerce_loaded钩子注册自定义产品类型，该钩子会在WooCommerce所有核心类、常量加载完成后触发，优先级建议设为20确保依赖全部就绪。

步骤2：调整类加载逻辑，避免自动加载提前触发 #

不要让自动加载器提前加载自定义产品类型类，改成在钩子回调中手动引入或者按需加载：
首先将自定义产品类型代码单独存为class-wc-product-gift-box.php，修正后的代码如下：

<?php
namespace giftbox\models\woocommerce;

class WC_Product_Gift_Box extends \WC_Product {
    // 构造方法需兼容父类参数规则
    public function __construct( $product = 0 ) {
        $this->product_type = 'gift_box';
        parent::__construct( $product );
    }

    // 可在此处添加自定义业务方法
}

然后在插件主文件中注册钩子逻辑：

<?php
// 先判断WooCommerce是否已激活，避免站点禁用WooCommerce时抛出错误
if ( in_array( 'woocommerce/woocommerce.php', apply_filters( 'active_plugins', get_option( 'active_plugins' ) ) ) ) {
    add_action( 'woocommerce_loaded', 'giftbox_register_custom_product_type', 20 );
}

function giftbox_register_custom_product_type() {
    // 手动引入自定义产品类文件，避免自动加载提前触发
    require_once plugin_dir_path( __FILE__ ) . 'path/to/class-wc-product-gift-box.php';
    
    // 将自定义类绑定到WooCommerce产品类型映射规则
    add_filter( 'woocommerce_product_class', 'giftbox_set_gift_box_product_class', 10, 2 );
    function giftbox_set_gift_box_product_class( $classname, $product_type ) {
        if ( $product_type === 'gift_box' ) {
            return \giftbox\models\woocommerce\WC_Product_Gift_Box::class;
        }
        return $classname;
    }

    // 可选：将自定义产品类型添加到后台产品编辑页的类型下拉选项
    add_filter( 'product_type_selector', 'giftbox_add_gift_box_to_type_selector' );
    function giftbox_add_gift_box_to_type_selector( $types ) {
        $types['gift_box'] = '礼品盒产品';
        return $types;
    }
}

步骤3：可选调整自动加载规则 #

如果你不想手动引入文件，可以在你的自动加载器规则中增加判断：只有当WC_Product类已存在时，才加载自定义产品类型相关的类文件，避免提前触发类找不到的错误。

额外说明 #

你之前手动引入abstract-wc-product.php报错，是因为WC_ABSPATH常量是在WooCommerce初始化阶段才定义的，提前引入文件时该常量尚未生成，不要手动引入WooCommerce核心文件，使用woocommerce_loaded钩子即可保证所有WooCommerce依赖就绪。

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