Next.js+Stripe Elements线上环境API密钥无效问题求助

问题核心 #

你遇到的问题是：AWS Amplify线上环境中，Next.js服务器组件无法读取STRIPE_SECRET_KEY环境变量，导致Stripe初始化时报「Invalid API Key provided」错误。本地运行正常是因为dotenv加载了本地.env文件，但Amplify部署环境不依赖本地配置文件，且Next.js服务器端有自带的环境变量加载逻辑。

解决方案 #

1. 移除冗余的dotenv代码

Next.js 13+的服务器组件/服务器端代码会自动加载环境变量，无需手动调用dotenv.config()。这段代码在Amplify环境中会尝试读取不存在的本地.env文件，反而干扰变量读取。修改后的代码如下：

import "server-only";

import Stripe from "stripe";

export const stripe = new Stripe(process.env.STRIPE_SECRET_KEY as string, {
  apiVersion: "2024-04-10",
});

2. 确认Amplify环境变量配置

在AWS Amplify控制台中完成以下操作：

• 进入你的Amplify应用 → 应用设置 → 环境变量
• 添加键为STRIPE_SECRET_KEY的变量，值填入你的Stripe密钥
• 勾选「将此变量应用于所有部署环境」（或针对目标环境单独配置）
• 点击保存后，重新触发一次部署（Amplify不会自动更新已部署环境的变量，必须重新部署生效）

3. 验证Next.js环境变量规则

• 服务器端/服务器组件使用的环境变量不需要添加NEXT_PUBLIC_前缀，该前缀仅用于客户端代码可访问的变量
• 确保本地.gitignore没有误排除Amplify相关配置文件（不过Amplify通过控制台管理变量，无需本地文件）

额外排查点 #

• 查看Amplify部署日志的构建阶段，搜索STRIPE_SECRET_KEY，确认变量是否被正确注入环境
• 禁止硬编码密钥（虽临时可用，但存在严重安全风险），确保Amplify环境变量的权限设置仅对部署环境开放

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