22. トラブル対応とデバッグ

この章では、WordPress制作・運用で起こりやすいトラブルと、切り分け方を学びます。

WordPressのトラブルは、テーマ、プラグイン、サーバー、データベース、キャッシュなど複数の要因が絡みます。

慌てず、どこで問題が起きているかを順番に確認します。

よくあるトラブル

WordPressでよくあるトラブルは次の通りです。

まずは、直前に何を変更したかを確認します。

トラブル対応では、変更前にバックアップを取ります。

原因を調べるためにファイルや設定を変更することがあります。

元に戻せない状態で作業すると、状況が悪化する可能性があります。

特に本番環境では、作業前の状態を保存してから対応します。

画面が真っ白になる場合、PHPエラーが起きている可能性があります。

確認することは次の通りです。

functions.phpの構文ミスでも画面が表示されなくなることがあります。

本番で直接編集するのは避け、ローカルやテスト環境で確認します。

投稿や固定ページが404になる場合、パーマリンク設定が関係していることがあります。

まず、管理画面でパーマリンク設定を開き、保存し直します。

それでも直らない場合は、次の点を確認します。

カスタム投稿タイプを追加した直後は、パーマリンク再保存が必要になることがあります。

プラグイン有効化後に不具合が起きた場合は、プラグインを切り分けます。

よくある確認方法は次の通りです。

本番で切り分けるとユーザーに影響する場合があります。

可能であれば、テスト環境で再現して確認します。

CSSやJavaScriptが効かない時は、次の点を確認します。

開発者ツールのNetworkやConsoleを使うと確認しやすいです。

画像が表示されない場合は、ファイルとURLを確認します。

移行後に画像が表示されない場合は、メディアファイルの移し忘れやURL置換漏れがよくあります。

WordPressには、デバッグ用の設定があります。

wp-config.phpでWP_DEBUGを有効にすることがあります。

wp-config.php

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

本番環境でエラーを画面に表示するのは避けます。

ログに出して確認するなど、安全な方法を使います。