☁️

Cloudflare環境でのStripe接続エラー解決方法

に公開
2025/07/26

概要

Next.js + Stripe環境において、ローカル開発環境では正常に動作するがCloudflareにデプロイした本番環境で以下のエラーが発生する問題の解決方法についての記事になります

Stripe session retrieval error: Error: An error occurred with our connection to Stripe. Request was retried 3 times.

発生環境

  • Next.js: 15.1.0
  • Stripe: 18.3.0
  • opennextjs/cloudflare: 1.5.1
  • wrangler: 4.25.0

問題のコード

app/api/stripe/route.ts
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY, {
  apiVersion: '2025-01-27.acacia',
  timeout: 60000,
  maxNetworkRetries: 3,
});

// 以下実行時にエラーが発生
session = await stripe.checkout.sessions.retrieve(sessionId);

解決策

Stripe初期化時にhttpClientの設定を追加することで解決できます。

app/api/stripe/route.ts
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY, {
  apiVersion: '2025-01-27.acacia',
  timeout: 60000,
  maxNetworkRetries: 3,
  httpClient: Stripe.createFetchHttpClient(), // この行を追加
});

session = await stripe.checkout.sessions.retrieve(sessionId);

なぜこの設定が必要なのか

デフォルトのHTTPクライアントの問題

Stripe Node.jsライブラリは、デフォルトでNode.jsのhttp/httpsモジュールを使用してHTTPリクエストを送信します。しかし、Cloudflare Workers環境では以下の理由で問題が発生します

  1. 実行環境の違い: Cloudflare Workersは標準的なNode.js環境ではなく、V8 JavaScript エンジン上で動作するサーバーレス環境

  2. Node.js APIの制限: Cloudflare Workers環境では、Node.jsのhttp/httpsモジュールが完全にはサポートされていないか、動作が不安定になる場合がある

  3. ネットワーク層の違い: Cloudflare Workers特有のネットワーク実装により、従来のNode.jsベースのHTTPクライアントとの互換性に問題が生じる可能性がある

createFetchHttpClientについて

Stripe.createFetchHttpClient()を使用することで

  • Fetch API使用: より現代的で標準化されたfetch APIを使用してHTTPリクエストを送信
  • 環境互換性: Cloudflare Workersを含む様々なJavaScript実行環境で安定動作
  • パフォーマンス向上: Cloudflare環境に最適化されたネットワーク処理

まとめ

今後はバイブコーディングで個人開発をする人が増えていき必然的にStripeで決済機能を実装したプロダクトをCloudflare Workers環境でデプロイする方が増えていくかと思いますが、Cloudflareでデプロイ予定の方はStripe APIクライアント初期化時はマストでhttpClientの設定を追加しておくことをおすすめします
個人的にかなりハマったポイントだったので誰かの役に立てれば幸いです

Discussion