ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
分野: トラブル解決 33件
絞り込みを解除- WordPressの変更が反映されない(キャッシュの種類と消し方) ブラウザ→キャッシュプラグイン→サーバーキャッシュ→CDN→Elementorの生成CSSの順に疑う。まずシークレットウィンドウやURLに ?v=数字 を付けて確認し、どの層のキャッシュかを切り分ける。消しても直らなければCSS優先順位・公開状態・見ているURLを確認する。
- WordPressのプラグイン・テーマ・本体・PHP更新の安全な手順(事前確認→バックアップ→1つずつ更新→確認→戻し方) 更新は止めない(脆弱性の多くは古いプラグイン)が、まとめて一気にやらない。バックアップ→更新内容の確認→1つずつ更新→表示・フォーム・管理画面を確認。本体のメジャー更新とPHP版の変更は別の日に。壊れたら直前に更新したものを止めて戻す。
- お問い合わせフォームのスパム対策(ハニーポット・reCAPTCHA・Turnstile・送信テスト・誤判定) まずプラグイン標準のハニーポット(見えない入力欄)を有効にし、それで足りなければ reCAPTCHA v3 か Cloudflare Turnstile を追加。導入後は必ずPC・スマホで実際に送信テストする(誤判定で正規の問い合わせが消えるのが一番の事故)。人が送る営業メールは完全には防げない。
- Astraでカスタム投稿の一覧・独自検索が10件に切られる(posts_per_page が上書きされる) Astra は parse_tax_query で、すべてのアーカイブ(カスタム投稿タイプの一覧も含む)の posts_per_page を「ブログの表示件数」(既定10)に上書きする。pre_get_posts で30件・100件にしても10件になり、独自の並べ替え検索では更新順の先頭10件だけが採点される。対策は astra_blog_post_per_page_exclusions フィルターに投稿タイプを追加して除外する(テーマ・設定は変えない)。
- WordPressのフォームメール・通知メールが届かない(迷惑メールに入る・自動返信が来ない) 「送信処理が失敗している」か「送れているが受信側で弾かれる」かを分ける。SMTPプラグインのテストメールとメールログで確認し、From・Reply-Toの設定、SPF/DKIM、受信側の迷惑メールを順に見る。
- ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意 原因を推測する前に、該当する層のログを見る。PHP・WordPress・Webサーバーはサーバー側、JSはConsole、通信はNetworkとAPIの応答本文、AI作業はClaude Codeの出力・作業ファイル。ログには個人情報・トークンが含まれるので、共有・保存するときは伏せる。
- 障害対応の基本(いきなり直さず症状を切り分ける14の確認順) 何が・いつから・全員か一部か・端末・回線を確認してから、DNS→サーバー→WordPress→プラグイン→外部サービス→ログ→直前変更の順に原因を絞る。修正はバックアップを確認してから1つずつ。
- 不正アクセス・改ざんが疑われるときの対応の流れ(状況保存→隔離→認証情報変更→範囲確認→クリーンな状態へ復旧→原因対策) 見覚えのない管理者・不審なファイル・勝手なリダイレクト・スパムページは侵入の兆候。まず状況を保存し、隔離を検討、全認証情報を変更、改ざん範囲を確認し、侵入前のクリーンなバックアップか正規ファイルで復旧、原因(脆弱性・パスワード)を塞いでから再確認する。
- 障害時は直前の変更を疑う・変更履歴を残す(更新・CSS・DNS・サーバー設定・PHP・SSL・外部サービス) 障害の多くは直前の変更がきっかけ。WordPress・プラグインの更新(自動更新含む)、CSS、DNS、サーバー設定、PHP、SSL、外部サービスの変更を最初に確認する。そのために、いつ・何を・どこで・変更前の値・戻し方を記録しておく。
- WordPressが真っ白・500エラー・「重大なエラーが発生しました」の切り分け(PHPエラー・プラグイン・テーマ・メモリ・PHP版・.htaccess・権限・ログ) まず直前の変更とエラーログを見る。原因の多くはプラグイン・テーマの更新、PHP版変更、メモリ不足、.htaccess。1つずつ切り分け(プラグイン→テーマ→.htaccess→メモリ→PHP版→権限)、大量変更はしない。
- スマホで横スクロールが出る(はみ出し要素の探し方と直し方) scrollWidth と clientWidth の差で横スクロールを判定し、右端をはみ出す要素をコンソールで探す。原因は固定幅・100vw・長い英数字・負のmargin・1frのグリッドなど。overflow-x:hidden で隠すのは最後の手段。
- 検索に出ない・Search Consoleで「インデックス未登録」になる原因と対処 まずURL検査でnoindex・robots・canonicalを確認する。設定起因(noindex・robots・canonical・リダイレクト)は直せばよく、「クロール済み/検出 - 未登録」は品質・内部リンク・新しさの問題で時間がかかる。
- GA4にデータが出ない・数値がおかしい(計測されない・二重計測・CVが取れない) まずソース表示で測定IDのタグが1回だけ出ているか、リアルタイムに自分が出るかを見る。出ない→タグ未設置・ID違い・キャッシュ・GTM未公開、2倍→二重設置、CV0→イベント名違い・キーイベント未指定。
- DNS変更・サーバー移転後に表示されない(DNS未反映か、新サーバー側の問題かを分ける) まず今そのドメインがどのIPを向いているかを確認し、「DNSがまだ旧サーバーを向いている(反映待ち・キャッシュ・hosts)」と「新サーバーを向いているのに壊れている(設定・SSL・ファイル)」を分ける。前者は待つかキャッシュを消す、後者は新サーバーを直す。
- Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ) 止まったらまず「何が完了し、何が途中か」を調査だけさせてから再開する。API一時エラーはファイル状態を確認して再実行、安全チェックの停止は回避せず許可を求める、長いコマンドや大きいヒアドキュメントは分割する。
- APIエラーの見方(200系・400・401・403・404・422・429・500系でどこを疑うか) 400系は「送った側」、500系は「相手側」の問題が基本。401は認証(キー・トークンの誤り・期限切れ)、403は権限・プラン・IP制限、404はURLや対象ID、429は回数制限、500系は相手の障害。まずエラー本文(JSON)を読む。
- AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる) 症状・再現条件・期待結果を渡し、仮説を並べさせてから実ブラウザで1つずつ確かめさせる。guidepocket.net ではHTML/CSSの静的チェックで「問題なし」とされた不具合が、実クリック調査で透明ヘッダーの重なりと特定できた。
- HPトラブル時にDevToolsのどこを見るか(Elements・Styles・Computed・Console・Network・Application・レスポンシブ表示) 見た目・CSSはElements/Styles/Computed、JSのエラー・警告はConsole、ファイルやAPIの読み込み・ステータス・速度はNetwork、Cookie・保存データはApplication、スマホ幅はデバイスツールバー。症状から見る場所を選ぶ。
- DevToolsのNetworkタブの見方(HTTPステータス・CSS/JS/画像・API(Fetch/XHR)・読み込み時間・キャッシュ) Networkを開いてから再読み込みし、種類(CSS/JS/Img/Fetch/XHR)で絞る。赤い行・404/500を探し、URLとステータスを確認。APIは行をクリックしてHeaders・Payload・Responseを見る。Disable cacheでキャッシュを除外、Preserve logで画面遷移後も記録を残す。
- DevToolsでCSSを調べる流れ(要素特定→Styles→Computed→その場で試す) 右クリック→検証で要素を選び、Stylesで効いている/打ち消されたルールと読み込み元、Computedで最終値を確認。その場で値を変えて試し、決まったらCSSファイルに反映する。
- DevToolsのConsoleの見方(JavaScriptエラー・warning・CORS・404・外部script・フォーム/イベントが動かない) 赤はエラー(処理が止まっている可能性)、黄色は警告。1つのJSエラーで以降の処理(メニュー・スライダー・フォーム)が全部止まることがある。最初に出たエラーから、ファイル名と行を見る。AIに渡すときはURL内のトークンや個人情報を伏せる。
- SSL/HTTPSの基本と「保護されていない通信」・Mixed Contentの直し方(証明書・Let's Encrypt・自動更新・http→https) SSLはサーバー側で証明書を発行し、http→httpsへ301で統一する。Let's Encryptは有効期間が短く自動更新が前提。「SSL済みなのに警告」はページ内の画像・CSS・JSがhttpで読まれるMixed Content。DevToolsで探し、DB内のURLはバックアップ後に安全な方法で置換する。
- CORSエラーの基本(別オリジン・ブラウザの制限・Access-Control-Allow-Origin・iframeとは別問題) ブラウザのJavaScriptから別オリジン(ドメイン・プロトコル・ポートが違う)のAPIを呼ぶと、相手のサーバーがAccess-Control-Allow-Originで許可していない限りブラウザが結果を読ませない。直すのは基本的にAPI側の設定か、自分のサーバー経由で呼ぶこと。ブラウザ側のコードだけで必ず解決できるものではない。iframeの表示可否は別問題。
- テスト用に注入したCSSが本番CSSより先に読み込まれて効かない ブラウザ検査で仮のCSSを注入したら、ページ内の本番CSSより前に入って上書きされず効かなかった。本番では<style>末尾に追記するので問題なし。テスト時は後ろに入れるか詳細度を上げる。
- ローカルのテンプレートCSSが公開中ページと一致しない(フル版CSSを正式採用) 手元のテンプレートは簡略版で、公開中ページのCSSと食い違っていた。公開中の多数派3ページ(2482・2519・2572)の共通CSSを正式基準にし、テンプレートと生成済み記事を合わせた。
- Windows PowerShell 5.1 で日本語スクリプトが壊れる(UTF-8 BOM が必要) PS 5.1 はBOMなしUTF-8スクリプトをANSIとして読むため日本語で構文エラーになる。BOMを付ける。変数名は大文字小文字を区別しないので $P と $p が衝突する。
- プロジェクトのファイル名が文字化けしている(UTF-8をCP932として解釈) スターターの一部ファイル名がUTF-8バイトをCP932で解釈した化け名のまま実在する。表示崩れではなく実名。サイズ条件などで特定して扱う。
- PCだけ・スマホだけ表示が崩れる、画像サイズがおかしい 片方の端末だけ崩れるときは、その幅でだけ効くメディアクエリ・ビルダーの端末別設定・固定値を疑う。崩れる幅を特定し、その範囲のルールだけを直す。画像は比率と幅指定の競合を確認。
- 親の固定ページが下書きだと子ページのURLが404になる 下書きの親はスラッグが確定しないため、公開した子のURLから親階層が抜けて404になる。親を公開すればスラッグが決まり解消。先に親を公開してから子を作る。
- CSSが効かない・変更が反映されないときのチェックリスト DevToolsで対象要素にルールが出ているかを最初に見る。出ていなければセレクタ・読み込み・キャッシュ、出ていて打ち消し線なら詳細度・読み込み順、出ていて効かないならメディアクエリ・display等の前提条件を疑う。