Woocommerce自动添加免费商品到购物车代码报错排查求助

先看你给出的代码片段，明显是截断了，这本身就会导致语法错误，不过结合常见的这类实现的坑，我来拆解下这段代码不够“干净”的地方，以及对应的修复思路：

你的需求很明确——让所有访客进店后，购物车自动加入一件免费商品，但原代码存在几个关键问题，直接导致了PHP日志里的报错：

• 语法不完整：你贴的代码到sizeof( WC(...就中断了，正常应该是sizeof(WC()->cart->get_cart())来获取购物车商品数量，没写完的话PHP会直接报「意外的文件结束」语法错误，这是最直观的问题。
• 未做WooCommerce Cart初始化检查：直接调用WC()->cart之前，没确认WooCommerce的购物车类是否已经加载完成。比如如果把函数挂到了太早的钩子（比如init早期阶段），此时WC的Cart组件还没初始化，会触发「调用未定义的对象/方法」的致命错误。
• 缺少钩子挂载逻辑：你只定义了函数，但没把它绑定到WooCommerce的合适钩子上（比如template_redirect）。如果没挂载，函数根本不会执行；如果挂错钩子，也会引发各种初始化类的错误。
• 未校验商品有效性：硬编码的$product_id = 99999如果对应的商品不存在，执行add_to_cart时会报「无效商品ID」的警告，平白污染日志。

我给你整理了修复后的完整代码，解决了以上所有问题：

/* AUTOMATICALLY ADD A PRODUCT TO CART ON VISIT */
function aaptc_add_product_to_cart() {
    // 仅在前台执行，且确保WooCommerce Cart组件已加载完成
    if ( ! is_admin() && function_exists( 'WC' ) && isset( WC()->cart ) ) {
        $product_id = 99999; // 替换成你的免费商品ID
        
        // 提前检查商品是否存在，避免无效操作
        if ( ! wc_get_product( $product_id ) ) {
            return;
        }
        
        $found = false;
        
        // 遍历购物车，确认商品是否已存在（避免重复添加）
        foreach ( WC()->cart->get_cart() as $cart_item_key => $cart_item ) {
            if ( $cart_item['product_id'] === $product_id ) {
                $found = true;
                break;
            }
        }
        
        // 商品不在购物车时，添加进去
        if ( ! $found ) {
            WC()->cart->add_to_cart( $product_id );
        }
    }
}
// 挂载到template_redirect钩子：前台模板加载前执行，此时Cart已完全初始化
add_action( 'template_redirect', 'aaptc_add_product_to_cart' );

简单说下核心修复点：

1. 增加了function_exists('WC')和isset(WC()->cart)的双重检查，彻底避免Cart未初始化的致命错误；
2. 补全了购物车遍历的完整逻辑，修复了原代码的语法截断问题；
3. 加入了商品存在性校验，无效ID直接退出，不会污染日志；
4. 选择template_redirect钩子，这是执行这类操作的最佳时机——既保证前台生效，又确保WC所有组件都已加载完毕。

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