ナレッジ
知識・原因・設定・過去のノウハウを探す場所です。やりたいこと・症状・ツール名で探せます。
「500エラー」の検索結果 76件(関連の高い上位50件を表示)
絞り込みを解除- WordPressが真っ白・500エラー・「重大なエラーが発生しました」の切り分け(PHPエラー・プラグイン・テーマ・メモリ・PHP版・.htaccess・権限・ログ) まず直前の変更とエラーログを見る。原因の多くはプラグイン・テーマの更新、PHP版変更、メモリ不足、.htaccess。1つずつ切り分け(プラグイン→テーマ→.htaccess→メモリ→PHP版→権限)、大量変更はしない。
- Claude Codeが途中で止まる(APIエラー・応答停止・サブエージェント待機・コンテキスト切れ) 止まったらまず「何が完了し、何が途中か」を調査だけさせてから再開する。API一時エラーはファイル状態を確認して再実行、安全チェックの停止は回避せず許可を求める、長いコマンドや大きいヒアドキュメントは分割する。
- APIエラーの見方(200系・400・401・403・404・422・429・500系でどこを疑うか) 400系は「送った側」、500系は「相手側」の問題が基本。401は認証(キー・トークンの誤り・期限切れ)、403は権限・プラン・IP制限、404はURLや対象ID、429は回数制限、500系は相手の障害。まずエラー本文(JSON)を読む。
- DevToolsのConsoleの見方(JavaScriptエラー・warning・CORS・404・外部script・フォーム/イベントが動かない) 赤はエラー(処理が止まっている可能性)、黄色は警告。1つのJSエラーで以降の処理(メニュー・スライダー・フォーム)が全部止まることがある。最初に出たエラーから、ファイル名と行を見る。AIに渡すときはURL内のトークンや個人情報を伏せる。
- AIでトラブル原因を切り分ける方法(静的チェックで終わらせず実ブラウザで確かめる) 症状・再現条件・期待結果を渡し、仮説を並べさせてから実ブラウザで1つずつ確かめさせる。guidepocket.net ではHTML/CSSの静的チェックで「問題なし」とされた不具合が、実クリック調査で透明ヘッダーの重なりと特定できた。
- AIに渡す指示テンプレート集(CSS修正・HTML修正・WordPress修正・トラブル調査・画像制作・検査・大量ページ制作) 用途別(A〜G)に、目的・変更対象・変更禁止・期待結果・PC/SP・出力形式・検査の7項目で書く短いテンプレート。汎用の型は ai-work-request-template、「他は変更しない」の定型文は ai-no-other-changes。
- CORSエラーの基本(別オリジン・ブラウザの制限・Access-Control-Allow-Origin・iframeとは別問題) ブラウザのJavaScriptから別オリジン(ドメイン・プロトコル・ポートが違う)のAPIを呼ぶと、相手のサーバーがAccess-Control-Allow-Originで許可していない限りブラウザが結果を読ませない。直すのは基本的にAPI側の設定か、自分のサーバー経由で呼ぶこと。ブラウザ側のコードだけで必ず解決できるものではない。iframeの表示可否は別問題。
- AIにサーバー運用・障害対応を手伝わせるときの任せ方(ログ整理・差分確認・チェックリストはAI、DNS・削除・本番設定変更は人) ログ整理・設定差分・エラー文の分類・確認コマンド案・移行/バックアップのチェックリスト・原因候補の整理はAIに任せやすい。DNS変更・サーバー/DB削除・本番DB一括更新・鍵変更・メールDNS・ドメイン移管・本番サーバー設定はAIだけでやらせない。必ずバックアップ・確認・限定変更を伴う。
- HPトラブル時にDevToolsのどこを見るか(Elements・Styles・Computed・Console・Network・Application・レスポンシブ表示) 見た目・CSSはElements/Styles/Computed、JSのエラー・警告はConsole、ファイルやAPIの読み込み・ステータス・速度はNetwork、Cookie・保存データはApplication、スマホ幅はデバイスツールバー。症状から見る場所を選ぶ。
- 不具合の原因を切り分ける 表示されない・エラー・押せない・急に崩れたときに、いきなり直さず、症状・いつから・範囲・層(DNS/サーバー/WordPress/ブラウザ)の順に絞り込む。
- サーバーの基本(種類・何がどこにあるか・public_html・PHP・DB・FTP/SFTP/SSH・権限・ログ) WordPressサイトは「ファイル(public_html以下)」と「データベース(MySQL/MariaDB)」の2つでできている。ファイルはSFTP/SSHで、DBはphpMyAdminやWP-CLIで扱う。権限はフォルダ755・ファイル644が基本、777にしない。困ったらエラーログを見る。
- Claude Code が作業前にナレッジを検索・追加する手順 作業前にサイト名・URL・作業内容・ツール・エラー文で search.ps1 を実行し、上位の必要なMarkdownだけ読む。再利用価値の高い確定事項・解決策だけを追加し、build-index.ps1 で索引を更新する。
- JavaScriptコピペ集(DOMContentLoaded・querySelector・click・classList.toggle・スクロール・表示切替・accordion・tab)ライブラリなし HTML/CSSだけで済むもの(アコーディオンはdetails/summary、ページ内リンクはscroll-behavior)はJSを使わない。JSが必要なときは DOMContentLoaded 後に querySelector で要素を取り、click で classList.toggle する形が基本。要素がないページでエラーにならないよう存在確認する。
- HTTPステータスとリダイレクトの基本(200・301・302・404・410・403・500・503) 301=恒久移転(URLを変えたとき)、302=一時移転(メンテ・キャンペーン)、404=存在しない、410=削除済み、403=アクセス禁止、500=サーバー内部エラー、503=一時的に利用不可。curl -I で確認できる。
- Windows PowerShell 5.1 で日本語スクリプトが壊れる(UTF-8 BOM が必要) PS 5.1 はBOMなしUTF-8スクリプトをANSIとして読むため日本語で構文エラーになる。BOMを付ける。変数名は大文字小文字を区別しないので $P と $p が衝突する。
- ログは推測の前に見る証拠(PHPログ・debug.log・Webサーバーログ・Console・APIレスポンス・Claude Codeログ)と保存時の注意 原因を推測する前に、該当する層のログを見る。PHP・WordPress・Webサーバーはサーバー側、JSはConsole、通信はNetworkとAPIの応答本文、AI作業はClaude Codeの出力・作業ファイル。ログには個人情報・トークンが含まれるので、共有・保存するときは伏せる。
- WordPressのプラグイン・テーマ・本体・PHP更新の安全な手順(事前確認→バックアップ→1つずつ更新→確認→戻し方) 更新は止めない(脆弱性の多くは古いプラグイン)が、まとめて一気にやらない。バックアップ→更新内容の確認→1つずつ更新→表示・フォーム・管理画面を確認。本体のメジャー更新とPHP版の変更は別の日に。壊れたら直前に更新したものを止めて戻す。
- お問い合わせフォームのスパム対策(ハニーポット・reCAPTCHA・Turnstile・送信テスト・誤判定) まずプラグイン標準のハニーポット(見えない入力欄)を有効にし、それで足りなければ reCAPTCHA v3 か Cloudflare Turnstile を追加。導入後は必ずPC・スマホで実際に送信テストする(誤判定で正規の問い合わせが消えるのが一番の事故)。人が送る営業メールは完全には防げない。
- リンク・ボタンがクリックできない(見えない要素の重なり・pointer-events・z-index) 最も多いのは透明な要素(ヘッダー、疑似要素、広がった余白)がリンクの上に重なっているケース。elementFromPoint で一番上の要素を特定し、リンク側に position:relative と z-index を足すか、重なる側に pointer-events:none を付ける。
- Astra透明ヘッダー(#masthead)で上部の戻るリンクが押せない Astraの透明ヘッダー #masthead(position:absolute; z-index:99)がページ上部に重なり、見えないまま戻るリンクのクリックを奪っていた。リンクだけに position:relative; z-index:100 を追加して解決。
- 障害対応の基本(いきなり直さず症状を切り分ける14の確認順) 何が・いつから・全員か一部か・端末・回線を確認してから、DNS→サーバー→WordPress→プラグイン→外部サービス→ログ→直前変更の順に原因を絞る。修正はバックアップを確認してから1つずつ。
- 不正アクセス・改ざんが疑われるときの対応の流れ(状況保存→隔離→認証情報変更→範囲確認→クリーンな状態へ復旧→原因対策) 見覚えのない管理者・不審なファイル・勝手なリダイレクト・スパムページは侵入の兆候。まず状況を保存し、隔離を検討、全認証情報を変更、改ざん範囲を確認し、侵入前のクリーンなバックアップか正規ファイルで復旧、原因(脆弱性・パスワード)を塞いでから再確認する。
- スマホで横スクロールが出る(はみ出し要素の探し方と直し方) scrollWidth と clientWidth の差で横スクロールを判定し、右端をはみ出す要素をコンソールで探す。原因は固定幅・100vw・長い英数字・負のmargin・1frのグリッドなど。overflow-x:hidden で隠すのは最後の手段。
- CSSが効かない・変更が反映されないときのチェックリスト DevToolsで対象要素にルールが出ているかを最初に見る。出ていなければセレクタ・読み込み・キャッシュ、出ていて打ち消し線なら詳細度・読み込み順、出ていて効かないならメディアクエリ・display等の前提条件を疑う。
- DNS変更・サーバー移転後に表示されない(DNS未反映か、新サーバー側の問題かを分ける) まず今そのドメインがどのIPを向いているかを確認し、「DNSがまだ旧サーバーを向いている(反映待ち・キャッシュ・hosts)」と「新サーバーを向いているのに壊れている(設定・SSL・ファイル)」を分ける。前者は待つかキャッシュを消す、後者は新サーバーを直す。
- 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はバックアップ後に安全な方法で置換する。
- 既存ページ保護ルール(指定箇所以外は触らない) 指定された箇所以外は変更しない。完成済みページを正式な基準にし、変更は必要最小限。作業後はバックアップとの差分で確認する。
- 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 フィルターに投稿タイプを追加して除外する(テーマ・設定は変えない)。
- テスト用に注入したCSSが本番CSSより先に読み込まれて効かない ブラウザ検査で仮のCSSを注入したら、ページ内の本番CSSより前に入って上書きされず効かなかった。本番では<style>末尾に追記するので問題なし。テスト時は後ろに入れるか詳細度を上げる。
- ローカルのテンプレートCSSが公開中ページと一致しない(フル版CSSを正式採用) 手元のテンプレートは簡略版で、公開中ページのCSSと食い違っていた。公開中の多数派3ページ(2482・2519・2572)の共通CSSを正式基準にし、テンプレートと生成済み記事を合わせた。
- プロジェクトのファイル名が文字化けしている(UTF-8をCP932として解釈) スターターの一部ファイル名がUTF-8バイトをCP932で解釈した化け名のまま実在する。表示崩れではなく実名。サイズ条件などで特定して扱う。
- 親の固定ページが下書きだと子ページのURLが404になる 下書きの親はスラッグが確定しないため、公開した子のURLから親階層が抜けて404になる。親を公開すればスラッグが決まり解消。先に親を公開してから子を作る。
- 実クリック検査でページ下部のリンクだけ失敗する(scrollIntoViewが効かない) body{overflow-x:hidden} のページでは scrollIntoView が期待どおり動かず、下段リンクのクリックが検査側で失敗する。scrollTo({behavior:'instant'}) で位置を指定してからクリックする。
- CSSが効かないときに原因を調べる 書いたCSSが効かないとき、DevToolsで「ルールがない/負けている/勝っているのに変わらない」の3つに分けて調べる。
- JSONの読み方(object・array・key・value・文字列・数値・boolean・null)HP制作とAPI連携で困らない範囲 JSONは {} のobject(key: valueの組)と [] のarray(並び)でデータを表す。値は文字列("で囲む)・数値・true/false・null・object・array。keyは必ず"で囲む、末尾カンマ不可、コメント不可が典型的なつまずき。
- WordPressの変更が反映されない(キャッシュの種類と消し方) ブラウザ→キャッシュプラグイン→サーバーキャッシュ→CDN→Elementorの生成CSSの順に疑う。まずシークレットウィンドウやURLに ?v=数字 を付けて確認し、どの層のキャッシュかを切り分ける。消しても直らなければCSS優先順位・公開状態・見ているURLを確認する。
- WordPressのフォームメール・通知メールが届かない(迷惑メールに入る・自動返信が来ない) 「送信処理が失敗している」か「送れているが受信側で弾かれる」かを分ける。SMTPプラグインのテストメールとメールログで確認し、From・Reply-Toの設定、SPF/DKIM、受信側の迷惑メールを順に見る。
- 障害時は直前の変更を疑う・変更履歴を残す(更新・CSS・DNS・サーバー設定・PHP・SSL・外部サービス) 障害の多くは直前の変更がきっかけ。WordPress・プラグインの更新(自動更新含む)、CSS、DNS、サーバー設定、PHP、SSL、外部サービスの変更を最初に確認する。そのために、いつ・何を・どこで・変更前の値・戻し方を記録しておく。
- 検索に出ない・Search Consoleで「インデックス未登録」になる原因と対処 まずURL検査でnoindex・robots・canonicalを確認する。設定起因(noindex・robots・canonical・リダイレクト)は直せばよく、「クロール済み/検出 - 未登録」は品質・内部リンク・新しさの問題で時間がかかる。
- GA4にデータが出ない・数値がおかしい(計測されない・二重計測・CVが取れない) まずソース表示で測定IDのタグが1回だけ出ているか、リアルタイムに自分が出るかを見る。出ない→タグ未設置・ID違い・キャッシュ・GTM未公開、2倍→二重設置、CV0→イベント名違い・キーイベント未指定。
- 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ファイルに反映する。
- PCだけ・スマホだけ表示が崩れる、画像サイズがおかしい 片方の端末だけ崩れるときは、その幅でだけ効くメディアクエリ・ビルダーの端末別設定・固定値を疑う。崩れる幅を特定し、その範囲のルールだけを直す。画像は比率と幅指定の競合を確認。
- AIでコードレビューする方法(観点を指定し、指摘は実機で確かめる) 観点(動作、表示崩れ、アクセシビリティ、既存との一貫性)と「指摘だけで修正しない」を指定する。指摘は重大度順に出させ、正しいかは実機・DevToolsで確かめてから直す。
- 安全な変更の流れ(バックアップ→DRY RUN→本番反映→検査→復旧手段の確認) 戻せる状態を作ってから変える。バックアップ→書き込みなしの試し実行→本番→差分検証→表示検査。普段は変更部分だけ検査し、全件検査は大きな節目だけ。
- ナレッジを追加・更新してサイトへ同期する 作業で分かったことを knowledge/ に足し、索引・チェックのあと guidepocket.net へ変更分だけ同期する。全件同期・全件監査はしない。
- 公開後検査(公開後チェック)の項目と方法(HTTP・H1・href="#"・実クリック・スマホ390px・横スクロール・既存差分) 公開後チェック。新規・変更ページに対して、サーバー側verify、HTTP/H1/プレースホルダ/href="#"、PC・スマホ390pxの実クリック、横スクロール、既存ページ差分を確認する。全体監査は節目だけ。
- guidepocket.net 制作ルール(CLAUDE.md・ページ作成ルール・文章ルールの要点) CLAUDE.md の最優先ルールと、その後のユーザー指示で固まった制作ルール(本文字数、戻るリンク仕様、H1、href="#"禁止など)の要点。
- WordPressを安全に変更する(バックアップ→変更→検査) ページ・設定・プラグインなどWordPressに書き込む作業の基本形。確認→バックアップ→対象限定→実行→検査の順で、1ステップずつ進める。
- 公開前・公開後のチェック ページやサイトを公開する前と後に見る項目を、作業の大きさに合わせて選ぶ。noindex の方針・フォーム・リンクの実クリックを忘れない。