WordPress WooCommerce PayPal插件无法创建referral报错

问题复现场景 #

• 操作路径：WordPress站点后台安装官方woocommerce-paypal-payments插件后，进入WooCommerce Payments标签页
• 预期结果：页面展示用于关联站点与PayPal账户的蓝色连接按钮
• 实际结果：按钮未加载，反复弹出以下错误提示：

We could not properly connect to PayPal. Try reloading the page. Could not create referral. /home/[站点实际路径]/wordpress/wp-content/plugins/woocommerce-paypal-payments/modules/ppcp-api-client/src/Endpoint/PartnerReferrals.php:85

可行排查与解决方向 #

• 校验服务器出站连通性
  该报错的核心触发逻辑是插件请求PayPal合作伙伴推荐接口失败，首先确认服务器未做外连限制：可以通过服务器cURL命令测试对PayPal API域名的HTTPS访问是否正常，同时检查服务器OpenSSL版本、CA根证书库是否过期，cURL扩展是否正常启用，很多国内云主机、配置了严格出站防火墙的环境会直接拦截该请求，触发报错。
• 排查插件/主题冲突
  临时禁用除WooCommerce、woocommerce-paypal-payments之外的所有插件，切换到WordPress官方默认主题（如Twenty Twenty系列、Storefront）后重试连接。绝大多数同类问题都是安全插件、缓存插件、站点加速插件篡改了出站请求参数、拦截了API请求，或是主题自定义代码修改了WooCommerce请求逻辑导致接口校验失败。
• 核对站点基础配置
  进入WordPress后台「设置-常规」页面，确认*WordPress地址（URL）和站点地址（URL）*配置完全一致，协议（http/https）、域名格式（带/不带www）统一，不要出现跨域、协议不匹配的情况。PayPal侧创建referral记录时会校验传入的站点域名参数，域名不匹配会直接返回创建失败。同时确认站点未开启维护模式、整站密码保护，避免PayPal侧无法完成站点连通性校验。
• 重置插件残留配置
  如果之前安装过其他PayPal集成插件、或是旧版本PayPal Payments插件残留了无效凭据、错误缓存，可以进入插件的高级设置页选择「重置所有设置」，清除所有残留连接数据后刷新页面重试。操作前建议提前备份站点数据库，避免自定义配置丢失。
• 校验版本兼容性
  确认当前运行的WooCommerce核心、woocommerce-paypal-payments插件均为官方发布的稳定版本，不要使用破解修改版、Beta测试版，版本不匹配会导致接口传参不符合PayPal要求，触发PartnerReferrals.php第85行的创建逻辑报错。如果是插件更新后立刻出现该问题，可以回滚到上一个已知正常的稳定版本重试。

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