自定义插件中WooCommerce结账异常：PayPal按钮无法正常加载

问题根源分析 #

• 手动强制woocommerce_is_checkout为true并直接调用[woocommerce_checkout]短码，未触发WooCommerce原生结账页的完整初始化流程，导致PayPal等支付网关的专属脚本未被正确入队。
• 原生结账页的PayPal按钮依赖wc-gateway-paypal脚本完成AJAX加载和初始化，而你仅加载了基础的wc-checkout脚本，缺失了支付网关的关键资源。
• 直接调用wc_get_template('checkout/form-checkout.php')崩溃，是因为该模板依赖全局$checkout对象及一系列前置初始化逻辑，未提前准备这些上下文会触发致命错误。

解决方案 #

1. 正确入队支付网关脚本 #

在wp_enqueue_scripts钩子中，针对自定义页面加载基础结账资源+PayPal网关脚本：

add_action('wp_enqueue_scripts', 'custom_checkout_enqueue_assets');
function custom_checkout_enqueue_assets() {
    // 替换为你的自定义结账页面slug
    if (!is_page('custom-product-checkout')) return;

    // 加载WooCommerce基础结账脚本与样式
    wp_enqueue_script('wc-checkout');
    wp_enqueue_style('wc-checkout');

    // 如果PayPal网关已启用，加载其专属脚本
    if (class_exists('WC_Gateway_Paypal')) {
        wp_enqueue_script('wc-gateway-paypal');
    }
}

2. 正确初始化结账上下文并渲染模板 #

不要直接调用短码或模板，先初始化结账对象并设置必要的上下文钩子：

function render_custom_checkout_form() {
    global $woocommerce;
    // 初始化WooCommerce结账对象
    $checkout = $woocommerce->checkout();

    // 设置结账页面标识钩子
    add_filter('woocommerce_is_checkout', '__return_true');
    add_filter('woocommerce_is_page', function($is_page) {
        return $is_page || is_page('custom-product-checkout');
    });

    // 安全渲染结账模板（用输出缓冲避免直接输出导致的header错误）
    ob_start();
    wc_get_template('checkout/form-checkout.php', array('checkout' => $checkout));
    return ob_get_clean();
}

将上述函数挂载到你的页面内容钩子，或直接在自定义页面模板中调用echo render_custom_checkout_form();

3. 验证PayPal网关设置 #

进入WooCommerce后台的设置 > 支付 > PayPal，确保「启用AJAX支付按钮」选项处于开启状态，这是原生动态按钮加载的前提。

关键注意事项 #

• 不要手动定义WOOCOMMERCE_CHECKOUT常量，WooCommerce会通过钩子自动处理页面标识。
• 确保自定义页面的用户会话正常、购物车非空，否则支付网关会触发验证错误。
• 若使用其他支付网关，可参考PayPal的方式，查找对应网关的注册脚本（比如Stripe的wc-gateway-stripe）。

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