はじめに
WooCommerceのカートページが「空のカート」と表示される、レイアウトが崩れる、またはチェックアウトに進めない場合、カートページの設定ミス、キャッシュ、テーマ・プラグインの競合が原因である場合がほとんどです。
症状・原因
- カートに商品を追加しても「カートは空です」と表示される
- カートページのURLが
/cart/ではなく別のURLになっている - カートページのレイアウトが崩れる
- カートページにリダイレクトループが発生する
解決手順
ステップ1：カートページの設定を確認する
WooCommerce → 設定 → 詳細設定 → ページ設定
- カートページ: 「カート」ページが選択されているか確認
- チェックアウトページ: 「チェックアウト」ページが選択されているか確認
- マイアカウントページ: 「マイアカウント」ページが選択されているか確認# WP-CLIでページ設定を確認
wp option get woocommerce_cart_page_id
wp option get woocommerce_checkout_page_id
wp option get woocommerce_myaccount_page_id
# ページが存在するか確認
wp post get $(wp option get woocommerce_cart_page_id) --fields=ID,post_title,post_status,post_contentステップ2：カートページのショートコードを確認する
カートページには [woocommerce_cart] ショートコードが必要です。
# カートページの内容を確認
wp post get $(wp option get woocommerce_cart_page_id) --field=post_content
# ショートコードが含まれていない場合は更新
wp post update $(wp option get woocommerce_cart_page_id) --post_content='<!-- wp:woocommerce/cart -->[woocommerce_cart]<!-- /wp:woocommerce/cart -->'または管理画面でカートページを編集し、[woocommerce_cart] ショートコードを追加します。
ステップ3：キャッシュをクリアする
# WP-CLIでキャッシュをクリア
wp cache flush
wp wc tool run clear_sessions --user=admin
# WooCommerceのTransientをクリア
wp wc tool run clear_transients --user=admin
# セッションテーブルをクリア
wp wc tool run cleanup_sessions --user=adminステップ4：テーマ・プラグイン競合を確認する
# デフォルトテーマに切り替えて確認
wp theme activate storefront # WooCommerce公式テーマ
# または twentytwentyfour
wp theme activate twentytwentyfour
# 他のプラグインを無効化して確認
wp plugin deactivate --all
wp plugin activate woocommerceステップ5：WooCommerceのページを再生成する
# 必須ページが不足している場合は再生成
wp wc tool run install_pages --user=admin
# パーマリンクを再保存
wp rewrite flush --hard注意事項
- キャッシュプラグイン（W3 Total Cache、WP Super Cache など）はWooCommerceのカート・チェックアウトページをキャッシュしないよう設定してください
- カートページのURLを変更した場合は
WooCommerce → 設定 → 詳細設定 → ページ設定で新しいURLのページを選択し直してください
まとめ
カートページ不具合の原因は「ページ設定のカートページ未選択」「[woocommerce_cart]ショートコードの欠落」「キャッシュ」の3つが多いです。wp wc tool run clear_transients でキャッシュをクリアし、ページ設定を確認することで大半の問題が解決します。