PrestaShop自定义支付模块出现“无法加载购物车”错误的解决求助

问题根源 #

$this->context->cart 返回null，通常是因为当前请求的上下文未正确关联有效的购物车——比如自定义控制器未继承正确基类，或购物车ID未通过Cookie传递到当前请求中。

具体修复方案 #

1. 手动从Cookie加载并验证购物车

PrestaShop会将购物车ID存储在前端Cookie中，我们可以先获取ID再手动实例化购物车，同时增加有效性校验：

public function createOrder(){
    // 从Cookie获取购物车ID
    $id_cart = (int)$this->context->cookie->id_cart;
    
    // 实例化购物车并验证有效性
    if ($id_cart) {
        $cart = new Cart($id_cart);
        // 检查购物车是否存在且属于当前客户
        if (!Validate::isLoadedObject($cart) || $cart->id_customer != $this->context->customer->id) {
            // 购物车无效，跳转到购物车页面
            Tools::redirect($this->context->link->getPageLink('cart'));
        }
    } else {
        // 无有效购物车ID，跳转到购物车页面
        Tools::redirect($this->context->link->getPageLink('cart'));
    }

    // 确认客户身份
    if (!$this->context->customer->isLogged()) {
        Tools::redirect($this->context->link->getPageLink('my-account'));
    }

    $total = (float)$cart->getOrderTotal(true, Cart::BOTH);
    $customer = new Customer($cart->id_customer);
    
    // 执行订单验证
    $order_validated = $this->module->validateOrder(
        $cart->id, 
        Configuration::get('PS_OS_PAYMENT'), 
        $total, 
        $this->module->displayName, 
        null, 
        array(), 
        $this->context->currency->id, 
        false, 
        $customer->secure_key
    );
    
    // 根据验证结果跳转
    if ($order_validated) {
        Tools::redirect($this->context->link->getPageLink(
            'order-confirmation', 
            Configuration::get('PS_SSL_ENABLED'), 
            $this->context->language->id, 
            'id_cart='.$cart->id.'&id_module='.$this->module->id.'&id_order='.$this->module->currentOrder.'&key='.$customer->secure_key
        ));
    } else {
        // 订单验证失败，跳转到订单页面
        Tools::redirect($this->context->link->getPageLink('order'));
    }
}

2. 确保控制器继承正确基类

如果createOrder方法在自定义模块的控制器中，必须让控制器继承FrontController，这样上下文才能自动加载客户、Cookie等核心信息：

class YourModulePaymentModuleFrontController extends ModuleFrontController
{
    public function postProcess()
    {
        $this->createOrder();
    }

    // 上述createOrder方法放在此处
}

关键校验说明 #

• 使用Validate::isLoadedObject($cart)确认购物车对象是否成功加载，避免后续调用方法报错。
• 增加客户登录状态检查，确保只有已登录用户才能触发订单验证。
• 校验validateOrder的返回结果，在验证失败时做友好跳转，避免白屏或无响应。

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