WordPressでよくあるエラー・不具合の対処法を21記事まとめました。症状から探せるように分類しています。
作業前にバックアップを取ることと、エラーログを見ること。この2つで解決までの時間が大きく変わります。ログの出し方はこのページの最後の章にまとめています。
目次
著者
WEB制作をしているデジタルノマド
WordPressのカスタマイズが好きで、色々と自作しています。
WordPressのカスタマイズに困ったらご相談ください!
管理画面に入れない・編集できない
管理画面に入れなくなると復旧の手段が限られます。まずセキュリティプラグインとログイン用URLの変更を疑ってください。
管理画面に404で入れなくなったときの解決方法です。SiteGuard WP Pluginが原因のケースを扱います。
あわせて読みたい
SiteGuardでログインできないときの対処|404・画像認証・ロック
SiteGuard WP Pluginを入れてからログインできないときは、症状から原因の機能を分けると早く戻れます。 多いのは「ログインURLが変わった」「管理ページが404になる」...
編集画面だけ開けない時の対応方法。
あわせて読みたい
WordPress│編集画面だけ開けない時の対応方法
操作前にデータベースとファイルのバックアップを確保します。 本文の救出は読み取りだけで行い、元記事を削除したりSQLで上書きしたりしません。 プラグイン停止やテー...
ウィジェットメニューが真っ白で表示されない時の解決方法。
あわせて読みたい
WordPress│ウィジェットメニューが真っ白で表示されない時の解決方法
これは旧ウィジェット画面へ一時的に切り替える回避策です。 白い画面の原因を直すものではありません。 WordPressの公式フィルターを使う例へ更新しました。 以下の画...
よく使用されるブロックを表示のリセット方法。
あわせて読みたい
WordPress│よく使うブロックが候補に出ないときの確認方法
一括削除する前に確認する 現在のWordPressにはユーザー設定をサーバー側へ保存する仕組みもあり、ブラウザーの値だけを消しても戻る場合があります。 必要なブロックを...
Site Kitでアナリティクスの連携がうまくいかないときの対処法です。
あわせて読みたい
Site Kit by Google│アナリティクスのアカウントの連携がうまくいかない時の対処方法│アナリティクス で...
「十分な権限がありません」は、WordPressの管理者権限とGoogle Analyticsのアクセス権が別であることに注意して切り分けます。 まずSite Kitで使用中のGoogleアカウン...
ページが表示されない・404・リダイレクト
「ページが見つかりませんでした」が出るときの.htaccessの直し方です。
あわせて読みたい
WordPressの記事が404になる・パーマリンクを変更できない時の直し方
「ページが見つかりませんでした。」と出て記事が404になるときは、公開済みでURLが合っているかを確かめ、「設定 → パーマリンク」で何も変えずに「変更を保存」を押し...
特定のページだけリダイレクトループが発生する時の対応方法。
あわせて読みたい
WordPressの404推測リダイレクトを止める方法|正規化と転送ループを区別する
存在しないURLから似た記事への推測転送だけを止めたい場合は、do_redirect_guess_404_permalinkフィルターを使います。 redirect_canonical全体の解除は、URL正規化ま...
サブドメイン追加後にSSL未反映で全サイトが真っ白になった原因と対処法。
あわせて読みたい
サブドメイン追加後のSSL警告・白画面を切り分ける手順
サブドメイン追加後に白画面や証明書警告が出た場合は、DNS・TLS・HTTP応答・WordPressを順に切り分けます。 旧版では証明書再発行を原因と断定していましたが、当時の...
メールが届かない
お問い合わせが届かない状態は、機会損失に直結します。SPF・DKIM・DMARCの設定は最初に済ませておいてください。
お問い合わせメールが届かない・迷惑メールに入る問題の設定手順です。SPF・DKIM・DMARCまで解説しています。
あわせて読みたい
WordPressのメールが届かない原因と対処法|フォーム・SMTP・Gmailを順番に確認
WordPressの問い合わせメールや自動返信が届かないときの確認手順を解説。フォームの宛先・From・Reply-To、SMTPの送信テスト、Gmailの認証結果を症状別に確認し、原因を切り分けます。
JavaScript・表示崩れ
Uncaught ReferenceError: jQuery is not definedの解決方法。
あわせて読みたい
SWELL│Uncaught ReferenceError: jQuery is not definedの解決方法
jQuery is not definedは、実行時点でjQueryが利用できないエラーです。 ファイルの未読み込み・取得失敗・実行順序を確認します。 jQuery(document).ready()で囲むだけ...
JSの遅延読み込み方法。Uncaught ReferenceError: hljs is not definedエラーの解消。
あわせて読みたい
WordPress│hljs is not definedの原因と読み込み順の直し方
hljs is not definedは、呼び出した時点でhighlight.jsのhljsが利用できないというエラーです。 原因には読み込み失敗、実行順序、ライブラリーの取り違えがあり、遅延...
iOSでリンクを2回タップしないと反応しない現象の直し方。
あわせて読みたい
WordPress│iOSでリンクを2回タップしないと反応しない現象の直し方
iPhoneで1回目のタップがhover状態の表示に使われ、2回目で移動することがあります。 ただし、透明な重なり要素やJavaScriptのpreventDefaultでも似た症状が出ます。 空...
Youtube埋め込み動画の上部に隙間ができた時の解決方法。
あわせて読みたい
SWELL│Youtube埋め込み動画の上部に隙間ができた時の解決方法
SWELLでYouTube埋め込みの上に隙間ができたら、まず動画の直前に空の段落・スペーサー・余白設定がないかを確かめます。 次に、空白が動画の外側にあるのか、プレーヤー...
Pjax遷移のSwiperカスタマイズの対応方法。
あわせて読みたい
SWELL│Pjax遷移のSwiperカスタマイズの対応方法
SWELLのPjaxで別ページから戻ると、自作のSwiperが動かなくなる場合の実装例です。 初回表示とPjax遷移後の両方で初期化し、専用クラスを付けたスライダーだけを対象に...
REST API 401エラー「swell-ct-pv」の原因と解決方法。
あわせて読みたい
SWELL│REST API 401エラー「swell-ct-pv」の原因と解決方法
SWELLの swell-ct-pv へのPOSTが401になると、PV計測に失敗している可能性があります。 ただし401だけでは原因のプラグインを特定できません。 リクエスト先、送信方法...
ファビコンで.icoを設定する方法。Microsoft Edge(Internet Explorer モード)対応。
あわせて読みたい
WordPressのファビコンにICOを使う場合の確認事項|サイトアイコンとIEモード
通常のサイトアイコンと、旧環境向けのico配信は分けて確認します。 WordPress本体のMIME一覧にはicoが標準で登録されています。 本記事の画面は過去の環境での例で、現...
PHP・テーマ更新に伴うエラー
PHPのバージョンを上げるときは、テーマとプラグインの対応状況を先に確認してください。
PHPバージョンを上げる前に確認すべきエラーと、ログの見方です。
あわせて読みたい
WordPress│PHPバージョン更新時に注意すべきエラーとエラーログの確認方法
PHPを切り替える前にファイルとDBをバックアップし、現在のPHPバージョンと戻し方を記録します。 デバッグはまずコピー環境で行います。 本番で必要な場合は短時間に限...
PHP8でJINテーマに出るUndefined array keyエラーの原因と解決方法です。
あわせて読みたい
JIN│Undefined array keyエラーの原因と解決方法
JINでPHPを8.2へ上げたとき、カテゴリーページにUndefined array keyの警告が出ました。当時はカテゴリーの編集画面で内容を変えずに「更新」すると、警告が表示されな...
バックアップ操作で504 Gateway Timeoutが発生!原因と対処法まとめ。All-in-One WP Migration。
あわせて読みたい
WordPress│バックアップ操作で504 Gateway Timeoutが発生!原因と対処法まとめ│All-in-One WP Migration
All-in-One WP Migrationでバックアップの削除・作成を行ったところ、サーバー上の全サイトが約3時間にわたって504 Gateway Timeoutで接続不能になりました。 この記事...
エラーログの見方
原因を推測する前にログを見るのが最短です。管理画面に表示せずログだけ残す設定にしておくと、本番でも安全に調査できます。
画面にエラーを出さず、ログだけを残す設定です。本番環境で安全に調査できます。
あわせて読みたい
WordPressのエラーログの場所と出力方法|画面に表示せずdebug.logで調べる
WordPressのエラーログ(debug.log)は、記録を有効にすると、通常 wp-content/debug.log に保存されます。画面に表示せず調べるには、wp-config.phpでデバッグログを有...
debug.logを管理画面で見やすく表示するカスタマイズ。
あわせて読みたい
WordPress│管理画面でデバッグログの末尾を確認する方法
WordPressのデバッグログは、短いコードを足すと、管理画面の「ツール」から末尾128KiBまで確認できます。 読むのはWP_DEBUG_LOGに設定したファイル(trueならwp-conten...