Express API路由无法读取.env存储的Stripe API密钥问题排查

报错是因为process.env.STRIPE_KEY取值为undefined，Node.js 运行时默认不会自动解析项目目录下的.env文件，你没有手动把.env里的配置加载到环境变量中，初始化Stripe实例时自然拿不到有效密钥。硬编码密钥能跑通就是最直接的佐证——代码逻辑本身没问题，只是环境变量读取失败。

• 1. 安装环境变量加载依赖dotenv，在项目根目录终端执行命令：

npm install dotenv

• 2. 确认.env文件位置和格式正确
     文件必须放在和package.json同级的项目根目录，内部配置不要加多余空格、不要给值套引号，正确写法：

  STRIPE_KEY=sk_test_51LJh5TCx0CP76PWrVKMBkQfuhm7tcgYZ2bhkx3yLApn3ugWiNEpd65V78uK3Z2nJzNSt2Gaga1bkFYZIAWoddJZ00n9quwkln
  

  注意：等号两侧不要留空格，密钥值如果套了引号或者前后有空格，会导致读取到的密钥包含多余字符，验证失败。
• 3. 在Express项目的入口文件（通常是server.js/app.js/index.js，也就是你写app.listen启动服务的文件）最顶部，第一行就加载dotenv配置，这步90%的人会漏：

// 必须放在所有其他require语句之前执行
require('dotenv').config()

// 后面再写原有服务逻辑
const express = require('express')
const app = express()
// 中间件配置、其他路由引入...
const stripeRouter = require('./routes/Stripe') // 替换成你实际的支付路由文件路径
app.use('/api/checkout', stripeRouter)

app.listen(5000, () => {
  console.log('后端服务已启动在5000端口')
})

• 4. 校验加载结果（可选）
     可以在dotenv加载完成后加一行打印，启动服务时看控制台输出，确认密钥读取正常：

require('dotenv').config()
console.log('Stripe密钥读取状态：', process.env.STRIPE_KEY ? '正常' : '为空，请检查.env配置')

控制台输出「正常」后再发起支付请求，就不会再提示未提供API key的错误。

• 不要在Stripe路由文件里单独引入dotenv。CommonJS的模块加载是同步执行的，你在路由文件顶部写const stripe = require("stripe")(process.env.STRIPE_KEY)时，路由文件里的dotenv配置还没来得及执行，此时process.env.STRIPE_KEY还是undefined，依然会报错。
• 记得在.gitignore文件里添加.env规则，不要把存了密钥的.env文件提交到代码仓库。你问题里贴出的测试密钥已经公开，正式上线前一定要去Stripe后台轮换生成新的密钥，避免被盗用产生资损。
• 如果是用新版Next.js、NestJS这类自带环境变量加载能力的框架，不需要手动安装dotenv，但要确认.env放在框架指定的目录，变量名符合框架的命名要求。

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