この記事で解決できること

環境

Stripe 決済導線の検証中（2026-06-17）、以下の状態が重なった。

この 2 点から「本番 Vercel に price ID が設定されていない → Stripe 決済が壊れている」と判断してデバッグを開始した。

vercel env ls production を叩いたところ、STRIPE_PRICE_ID は本番に設定済みだった。

Stripe の LIVE モードで決済画面を直接開くと、チェックアウトページまで正常に到達できた。

推測は外れていた。本番は正常だった。

.env.local はローカル開発専用のファイルです。Vercel の環境変数とは完全に独立しています。

場所	環境変数の管理
ローカル開発	`.env.local`（gitignore 対象）
Vercel production	Dashboard → Settings → Environment Variables
Vercel preview	同上（production と別設定可能）

件数が 0 件の原因には複数の解釈がある。

この 3 つを区別せず 1 を即採用したのがミスだった。

# Step 1: 本番の環境変数を確認
vercel env ls production

# Step 2: Stripe の LIVE モードで決済画面を直接開く
# （チェックアウトページまで到達できるか自分で確認する）

# Step 3: 完了が 0 件でも、まず本番フローを直接試す

ローカルの状態を本番の代理にしない。本番は本番で直接確認する。

AI ツールを業務に組み込む設計の実験ログを書いています。 https://masatoman.net