WooCommerce 10.8.4 でチェックアウトエラーが出た時の原因と直し方
WooCommerce をバージョン 10.8.4 にアップデートしたあとチェックアウト時に「billingAddress.address.country の値が無効」というエラーが出る場合、決済時の国コードの受け渡しに問題が起きている。まずはバージョンを 10.8.2 に戻してチェックアウトが正常に動くか確認し、並行して住所フィールドのカスタマイズ状況やプラグイン競合の調査に着手するのが最短の解決ルートだ。
チェックアウトの国コードエラーはなぜ起きるのか
WooCommerce 10.8.4 ではチェックアウトブロック（Store API）の住所バリデーションが強化され、Stripe 決済時に送信される国コードの整合性チェックがより厳密になった。請求先住所の国フィールドが空だったり、ISO 3166-1 alpha-2 形式（JP、US など2文字）以外の値が渡されたりすると「billingAddress.address.country should be one of the following strings: …」というエラーが発生する。
具体的には、前のバージョンまでは許容されていた空文字やデフォルト値の扱いが 10.8.4 でエラー扱いに変わった可能性が高い。実際に 10.8.2 へのロールバックでエラーが消えたという報告も、このバリデーション変更がトリガーであることを示している。
また、下記のような要因が重なるとエラーが顕在化しやすい。
- チェックアウト画面で国選択フィールドを非表示にするカスタマイズを施している
- 自動住所入力プラグイン（Yamato や Japan Post 連携など）が国コードを正しくセットできていない
- デフォルトの販売国設定（WooCommerce → 設定 → 一般）が無効な値になっている
- 子テーマの functions.php でチェックアウトフィールドを加工しているが、国フィールドの扱いが抜けている
チェックアウトエラーを解消する3つの方法
エラーを即時に止めるにはバージョンを戻すのが確実だが、根本原因を潰して 10.8.4 を使い続ける場合は以下の手順で対処を進める。
エラーが表示されている状況を Before、修正後にチェックアウトが完了する状態を After として切り分け、各ステップで状況がどう変化するかを見極めていく。
STEP 1「ロールバックでエラーを緊急停止させる」
チェックアウトが完全に止まって売上に影響が出ているなら、先に WooCommerce を 10.8.2 へ戻す。WP Rollback プラグインを使うか、公式リリースアーカイブから手動で上書きする。ロールバック後にチェックアウトが正常化すれば、原因が 10.8.4 の変更にあると確定できる。
STEP 2「エラーログから欠落している値を特定する」
WooCommerce の「ステータス → ログ」で Stripe 関連のエラーログを調べる。障害が発生した時刻付近のログを開き、country フィールドに何がセットされていたか（空文字、undefined、配列など）を確認する。合わせて「WooCommerce → 設定 → 一般」の販売国と通貨が正しく設定されているかもチェックする。販売国が意図せず空欄や「ZZ」などの無効な値になっていると、チェックアウトブロックが国コードを解決できずにエラーになる。
STEP 3「国フィールドのカスタマイズを洗い出して修正する」
チェックアウト画面で国フィールドを非表示にしている場合、非表示でもデフォルトで「JP」が送信されるようにする必要がある。具体的には、woocommerce_checkout_fields フィルターで ‘class’ を操作しているなら ‘default’ 値も同時に指定する。
自動住所入力プラグインを使っている場合は、該当プラグインが WooCommerce 10.8.4 に対応しているか開発元に確認する。一時的にプラグインを無効化し、手動で国を選択した場合にエラーが消えるなら、プラグイン側の値の受け渡し不具合が原因だ。
Stripe のバリデーションは ISO 3166-1 alpha-2 の厳密な2文字コードを要求する。「JPN」などの3文字コードや日本語表記が混入している場合は、コード変換の処理を挟むか、そもそもコードが混入しないようにする。
WooCommerce 10.8.4 で国フィールドの値を正規化する設定例
チェックアウトブロックで国フィールドを非表示にしつつ、デフォルト値を正しくセットするには次のようなコードを子テーマの functions.php に追加する。これは WooCommerce の標準フィルターフックを使った基本的な対処だ。
add_filter( 'woocommerce_checkout_fields', function( $fields ) {
// 請求先住所の国フィールドを非表示にしつつデフォルト値を「JP」に固定
$fields['billing']['billing_country']['default'] = 'JP';
$fields['billing']['billing_country']['class'][] = 'hidden';
return $fields;
});チェックアウトブロック（Store API）で同じ挙動を期待する場合は、woocommerce_store_api_checkout_update_order_from_request アクションで国コードを強制的にセットする方法もある。ただし、ブロック版チェックアウトはフィールド制御の仕組みが従来のショートコード版と異なるため、プラグインでの対応が追いついていないケースも多い。動作確認は必ず実際のブロックチェックアウト画面で行う。
WooCommerce Blocks とクラシックチェックアウトの違いに注意する
WooCommerce 10.8.x 系ではチェックアウトブロックが標準化され、従来の [woocommerce_checkout] ショートコードとは住所フィールドの内部処理が大きく変わった。特に住所の構造が「address_1」「address_2」「city」「state」「postcode」「country」に正規化されており、カスタムフィールドがこれに準拠していないと Store API がエラーを返す。
もしショートコード版チェックアウトに戻してエラーが消えるなら、使用しているテーマやプラグインがチェックアウトブロックに未対応の可能性が高い。一時的に従来のチェックアウトに切り替えて運用を続け、その間に対応版を待つのも現実的な選択肢だ。
よくある質問
WooCommerce 10.8.4 に上げたあと国コードエラーが出るが、ロールバック以外にすぐできる対処はあるか
WooCommerce → 設定 → 一般 で「販売国」が正しく選択されているか確認する。空欄や無効な値の場合、チェックアウトブロックが国コードを解決できずにエラーになる。日本向けサイトなら「日本」を選択し、保存してからチェックアウトを再テストする。
エラーログにはどのような情報が記録されているのか
WooCommerce → ステータス → ログ で「stripe-…」で始まるログファイルを開くと、Stripe へのリクエスト内容とレスポンスが記録されている。country フィールドが空や null、あるいは想定外の型で送信されていれば、ここにエラー詳細が残っている。
自動住所入力プラグインを無効化したらエラーが消えた。どうすればよいか
そのプラグインがチェックアウトブロックに対応していない可能性が高い。プラグイン開発元に対応状況を問い合わせるか、チェックアウト画面を従来のショートコード版に切り替えて運用を継続する。プラグイン側のアップデートを待つ間の暫定策として有効だ。
子テーマでチェックアウトフィールドをカスタマイズしている。何をチェックすべきか
functions.php 内で woocommerce_checkout_fields フィルターを使っている場合、請求先住所の ‘billing_country’ に ‘default’ と ‘value’ が正しく設定されているか確認する。フィールドを非表示にしている場合は特に、内部的に有効な国コードが渡るよう ‘default’ を明示する。
WooCommerce Blocks のチェックアウトをショートコード版に戻す方法は
チェックアウトページの編集画面を開き、チェックアウトブロックを削除して、代わりにショートコードブロックを追加し [woocommerce_checkout] と入力する。ページを更新後、実際の画面で住所入力から決済まで一通りテストする。
この記事のポイント
- WooCommerce 10.8.4 の国コードバリデーション強化がエラーの直接原因
- 緊急時は 10.8.2 へロールバックし、並行してエラーログを解析する
- 国フィールドの非表示や自動入力プラグインがエラーを誘発しやすい
- チェックアウトブロックとショートコード版の動作差異も切り分けの鍵
- 根本対処ではデフォルト国コード「JP」の明示的な指定が有効
・ Reddit、Stack Overflow、WordPress.org フォーラムを日々巡回し、現場の悩みを拾い上げて記事化
・ WordPress、WooCommerce、Next.js などモダンWeb制作領域のトラブルシューティングが専門
・ 「検索しても答えが見つからなかった」を一つでも減らすことが目標
・ エラーメッセージから根本原因にたどり着く粘り強い調査が得意
・ 初心者がつまずきやすい箇所を先回りで解決する記事作りを心がけている