Raptioの運用中、発生しやすい一般的なトラブルと、その解決に向けた基本的な診断・対処手順をまとめました。
1. 画面が真っ白になる（ホワイトスクリーン）
サイトにアクセスしても何も表示されず、画面が真っ白になる現象です。
原因: 主にPHPの構文エラーや、プラグインの競合、メモリ不足が考えられます。
解決策:
エラーログの確認: サーバー内の error_log ファイルを開き、エラーの発生箇所（ファイル名と行数）を特定します。
直近の編集箇所の確認: 直前に編集したPHPファイルを元に戻してください。
全プラグインの一時無効化: /plugins/ ディレクトリ名を一時的に別の名前に変更し、プラグインをすべて強制停止して表示されるか確認してください。
2. 管理画面にログインできない
ログイン情報を入力しても弾かれる、またはエラーになる場合です。
原因: データベースのパスワード不整合や、セッション情報の破損などが考えられます。
解決策:
認証データの照合: データベースを直接確認し、ユーザーIDとパスワード（ハッシュ化されている場合は再設定）が正しいか確認します。
ブラウザキャッシュのクリア: ログインセッションが古い情報を保持している可能性があるため、ブラウザのクッキーを削除してください。
3. デザインが崩れる（CSSが反映されない）
スタイルシートを修正したのに、レイアウトが崩れたままになる現象です。
原因: CSSの記述ミスや、ブラウザ・サーバー側のキャッシュ残存が主な原因です。
解決策:
CSSの文法チェック: ブラウザの「検証ツール」を開き、コンソールにCSSエラーが出ていないか確認します。
キャッシュの強制クリア: 前述の手順に従い、ブラウザのスーパーリロードとサーバー側のキャッシュ削除を行ってください。
4. 記事や画像がアップロード・保存できない
投稿の保存時にエラーが出る、または画像がアップロードできない現象です。
原因: サーバーの書き込み権限不足、またはディスク容量の枯渇が考えられます。
解決策:
ディレクトリ権限の確認: /uploads/ やデータを保存するディレクトリが、Webサーバーに対して書き込み許可（755または777）になっているか確認してください。
ディスク容量の確認: レンタルサーバーの管理画面から、契約容量を超えていないか確認します。
5. リンク切れ・404エラーが発生する
特定のページへアクセスすると404エラーになる現象です。
原因: リンク設定の誤りや、サーバー側のリライト設定ミスです。
解決策:
パーマリンク/パスの確認: 設定しているURL構造が実際のファイル構成と一致しているか確認してください。
リライト設定の再確認: サーバーの設定ファイル（ .htaccess 等）が正しく配置されているか確認してください。
トラブル解決の鉄則
まずはログを見る: 全てのトラブルにおいて、エラーログを確認することが最短の解決ルートです。
変更箇所を特定する: 最後に「何をいつ変更したか」を整理してください。
バックアップから復元: どうしても解決できない場合は、正常に動作していた直前の状態へファイルを上書きして復元するのが最も安全です。