WordPressでよくあるエラー・不具合の対処法を21記事まとめました。症状から探せるように分類しています。
作業前にバックアップを取ることと、エラーログを見ること。この2つで解決までの時間が大きく変わります。ログの出し方はこのページの最後の章にまとめています。
目次
著者
WEB制作をしているデジタルノマド
WordPressのカスタマイズが好きで、色々と自作しています。
WordPressのカスタマイズに困ったらご相談ください!
管理画面に入れない・編集できない
管理画面に入れなくなると復旧の手段が限られます。まずセキュリティプラグインとログイン用URLの変更を疑ってください。
管理画面に404で入れなくなったときの解決方法です。SiteGuard WP Pluginが原因のケースを扱います。
あわせて読みたい
管理画面にNot Found(404)で入れない場合の解決方法│SiteGuard WP Plugin
SiteGuard WP Pluginを使っていて管理画面が404になる場合は、最初に変更後のログインURLから再ログインします。404だけで原因を決めつけたり、.htaccessの設定をすべて...
編集画面だけ開けない時の対応方法。
あわせて読みたい
WordPress│編集画面だけ開けない時の対応方法
操作前にデータベースとファイルのバックアップを確保します。本文の救出は読み取りだけで行い、元記事を削除したりSQLで上書きしたりしません。プラグイン停止やテーマ...
ウィジェットメニューが真っ白で表示されない時の解決方法。
あわせて読みたい
WordPress│ウィジェットメニューが真っ白で表示されない時の解決方法
これは旧ウィジェット画面へ一時的に切り替える回避策です。白い画面の原因を直すものではありません。WordPressの公式フィルターを使う例へ更新しました。以下の画像は...
よく使用されるブロックを表示のリセット方法。
あわせて読みたい
WordPress│よく使うブロックが候補に出ないときの確認方法
一括削除する前に確認する 現在のWordPressにはユーザー設定をサーバー側へ保存する仕組みもあり、ブラウザーの値だけを消しても戻る場合があります。 必要なブロックを...
Site Kitでアナリティクスの連携がうまくいかないときの対処法です。
あわせて読みたい
Site Kit by Google│アナリティクスのアカウントの連携がうまくいかない時の対処方法│アナリティクス で...
「十分な権限がありません」は、WordPressの管理者権限とGoogle Analyticsのアクセス権が別であることに注意して切り分けます。まずSite Kitで使用中のGoogleアカウント...
ページが表示されない・404・リダイレクト
「ページが見つかりませんでした」が出るときの.htaccessの直し方です。
あわせて読みたい
WordPress│「ページが見つかりませんでした。」と表示される時の解消方法│.htaccessの更新
公開済みの記事が404になる原因は、URLの誤り、非公開・削除、書き換えルール、移行先の設定などです。 WordPressの書き換えルールを再生成することで直る場合がありま...
特定のページだけリダイレクトループが発生する時の対応方法。
あわせて読みたい
WordPressの404推測リダイレクトを止める方法|正規化と転送ループを区別する
存在しないURLから似た記事への推測転送だけを止めたい場合は、do_redirect_guess_404_permalinkフィルターを使います。redirect_canonical全体の解除は、URL正規化まで...
サブドメイン追加後にSSL未反映で全サイトが真っ白になった原因と対処法。
あわせて読みたい
サブドメイン追加後のSSL警告・白画面を切り分ける手順
サブドメイン追加後に白画面や証明書警告が出た場合は、DNS・TLS・HTTP応答・WordPressを順に切り分けます。 旧版では証明書再発行を原因と断定していましたが、当時の...
メールが届かない
お問い合わせが届かない状態は、機会損失に直結します。SPF・DKIM・DMARCの設定は最初に済ませておいてください。
お問い合わせメールが届かない・迷惑メールに入る問題の設定手順です。SPF・DKIM・DMARCまで解説しています。
あわせて読みたい
WordPress│お問い合わせメールが届かない・迷惑メールに届く場合の設定方法│Gmail│SMTP・SPF・DKIM・DMARC
WordPressからのメールが届かない場合は、実際の送信サービスとFromアドレスを確認してから、SMTP・SPF・DKIM・DMARCを点検します。Gmailの送信者ガイドラインは、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埋め込みの上に大きな空白がある場合、ブロックの余白と、動画の縦横比を確保する領域を分けて調べます。この記事には2024年6月の表示記録を残しています...
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を設定する方法│Microsoft Edge(Internet Explorer モード)対応
通常のサイトアイコンと、旧環境向けの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へ変更した際、カテゴリーの表示時に警告が出た過去の事例です。ここでは警告の読み方と、当時行ったカテゴリーの再保存を紹介します。すべ...
バックアップ操作で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のPHPエラーを画面に表示せず調べるには、wp-config.phpでデバッグログを有効にし、エラー表示を無効にします。標準の保存先は通常 wp-content/debug.log です...
debug.logを管理画面で見やすく表示するカスタマイズ。
あわせて読みたい
WordPress│管理画面でデバッグログの末尾を確認する方法
WordPress管理画面の「ツール」からデバッグログの末尾だけを読む例です。ログを書き換えず、日別の総件数は集計しません。 ログの保存先を先に確認 WP_DEBUG_LOGに設定...