Electron集成Stripe Terminal时loadStripeTerminal返回null怎么办

安全阿岳

2026-10-2

问题根因

@stripe/terminal-js 提供的loadStripeTerminal方法仅支持在浏览器环境运行，内部会检测当前上下文是否存在window对象，若检测为Node.js服务端环境（无window对象）就会直接返回null。你遇到的问题大概率是把初始化逻辑写在了Electron的主进程中，主进程为纯Node.js运行环境，不符合该SDK的运行要求。

解决方案

1. 调整代码执行上下文

将所有Stripe Terminal相关逻辑迁移到Electron的渲染进程中执行，渲染进程为标准Chromium浏览器上下文，完全符合SDK运行要求。

若你开启了Electron默认的contextIsolation配置，不要把初始化逻辑写在主进程、预加载脚本的Node.js作用域中，需放在渲染层前端代码内执行。
调用loadStripeTerminal时需传入你的Stripe账号公钥，缺省该参数也可能导致初始化失败。

2. 修正后代码示例（渲染进程内执行）

// 渲染进程前端代码
import { loadStripeTerminal } from '@stripe/terminal-js';

async function setupStripe() {
  // 替换为你自己的Stripe publishable公钥
  const StripeTerminal = await loadStripeTerminal('pk_test_xxxxxx你的公钥xxxxxx');
  if (!StripeTerminal) {
    console.error('Stripe Terminal初始化失败，请检查运行环境');
    return;
  }
  // 初始化终端实例
  const terminal = StripeTerminal.create({
    onConnectionStatusChange: (status) => {
      console.log('终端连接状态变更：', status);
    },
    onPaymentStatusChange: (status) => {
      console.log('支付状态变更：', status);
    }
  });
}

setupStripe();