npm安装Stripe后调用require('stripe')报非函数类型及API密钥缺失错误

编辑器警告「stripe method expression is not of Function type」解决 #

该警告的核心原因是require('stripe')返回的值不是可执行的函数/构造函数，按以下步骤排查：

• 首先验证Stripe版本与导入方式是否匹配：Stripe v10及以上版本对CommonJS导入做了调整，直接用require('stripe')返回的是模块对象而非构造函数，需要改成如下写法：

  const stripe = require('stripe').default(process.env.STRIPE_SECRET_KEY);
  

  如果你项目的package.json中配置了"type": "module"（即ESM模块模式），不能用require导入，需使用ESM导入语法：

  import Stripe from 'stripe';
  const stripe = new Stripe(process.env.STRIPE_SECRET_KEY);
  

• 如果是TypeScript项目，需确保安装了最新的类型定义文件：

  npm install --save-dev @types/stripe
  

• 如果依赖安装异常，可清理缓存后重装：

  rm -rf node_modules package-lock.json yarn.lock
  npm install
  

运行时报错「You did not provide an API key」解决 #

即使直接填入明文密钥仍报错，可按以下步骤排查：

• 优先确认导入方式是否符合上文要求，导入方式错误时，传入的密钥不会被Stripe构造函数接收，自然会识别为未传入密钥。
• 打印验证传入的密钥值是否有效：在初始化代码前添加日志，确认密钥没有多余空格、换行符，格式为sk_test_或sk_live_开头的正确私钥，不要误填入pk_开头的公钥。

  console.log('传入的Stripe密钥：', process.env.STRIPE_SECRET_KEY);
  

• 全局检索项目中所有Stripe初始化代码，确认没有其他位置的初始化逻辑漏传密钥，覆盖了当前正确的实例。

有效性验证 #

可运行最小测试用例验证环境是否正常：

// 新建test-stripe.js，CommonJS模式使用该代码
const stripe = require('stripe').default('替换为你的sk开头真实密钥');
(async () => {
  try {
    const balance = await stripe.balance.retrieve();
    console.log('Stripe初始化成功，账户余额：', balance);
  } catch (err) {
    console.error('初始化失败：', err.message);
  }
})();

执行node test-stripe.js，如果运行成功说明环境无问题，故障出在原项目的导入或环境变量加载逻辑；如果仍报错可固定安装最新版Stripe后重试：npm install stripe@latest --save

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