Magento 2.1.x使用paypal_express编程创建订单遇无效令牌错误

这个#10410: Invalid token错误是PayPal Express流程里最常见的问题之一，核心原因是你传递给PayPal API的token要么过期、不匹配，要么在流程中丢失/篡改了。结合你说之前能正常创建订单，现在突然失效的情况，我给你梳理几个针对性的排查和解决步骤：

1. 核对Token的完整生命周期流程 #

PayPal Express的标准流程是SetExpressCheckout → GetExpressCheckoutDetails → DoExpressCheckoutPayment，这三步必须使用同一个token，而且token是绑定会话和请求的：

• 检查你自定义模块里，是不是在SetExpressCheckout获取到token后，正确存储到了Magento的会话中（推荐用\Magento\Checkout\Model\Session），后续的Get和Do步骤是不是从同一个会话里取的token，有没有被其他逻辑覆盖或者清空。
• 注意PayPal的token有效期一般是3小时，如果用户在结账过程中停留太久，token会过期，这种情况要重新发起SetExpressCheckout获取新token。

2. 验证API环境与参数的一致性 #

• 确认你没有切换PayPal的环境：比如之前用Sandbox环境的token，现在误调用了Production的API，或者反过来，环境不匹配会直接导致token无效。
• 检查SetExpressCheckout请求里的RETURNURL和CANCELURL，必须和当前站点的域名、路径完全一致（包括http/https），PayPal会验证这些URL的合法性，不匹配的话也会触发token无效错误。
• 执行DoExpressCheckoutPayment时，除了token，必须同时传递PAYERID（这个是从GetExpressCheckoutDetails的响应里获取的），缺少payerId也会导致PayPal判定token无效。

3. 排查会话与缓存问题 #

• 确认Magento的会话机制正常：自定义模块里不要用原生PHP的$_SESSION，一定要用Magento自带的会话模型，避免因为会话存储配置（比如Redis、文件）变更导致token丢失。
• 清理Magento缓存：执行以下命令清空缓存，避免旧的配置或会话缓存干扰：

  bin/magento cache:flush
  bin/magento cache:clean
  

4. 开启PayPal日志定位问题 #

开启Magento的PayPal debug日志，能直接看到API请求和响应的细节：

1. 后台路径：Stores > Configuration > Sales > Payment Methods > PayPal Express Checkout > Advanced Settings
2. 开启Debug Mode，保存配置
3. 重新触发结账流程，然后查看var/log/paypal.log：
   • 对比SetExpressCheckout响应里的TOKEN值，和后续GetExpressCheckoutDetails、DoExpressCheckoutPayment请求里的token是否完全一致
   • 查看日志里有没有其他隐藏的错误提示，比如权限不足、参数错误等

5. 代码层面的细节检查 #

• 检查你提取token的逻辑：PayPal API响应里的token字段是大写的TOKEN，不要写成小写的token，比如：

  // 正确的方式
  $token = $response['TOKEN'];
  // 错误的方式（会导致token为null）
  $token = $response['token'];
  

• 检查DoExpressCheckoutPayment的调用逻辑，确保token存在再发起请求：

  $token = $this->checkoutSession->getPaypalExpressToken();
  $payerId = $this->checkoutSession->getPaypalExpressPayerId();
  
  if (!$token || !$payerId) {
      throw new \Magento\Framework\Exception\LocalizedException(__('Invalid PayPal token or payer ID.'));
  }
  
  $api->setToken($token);
  $api->setPayerId($payerId);
  // 执行DoExpressCheckoutPayment请求
  

• 如果你最近修改过自定义模块的代码，先回滚到之前能正常运行的版本，排查是不是代码变更导致的token传递异常。

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