2026年7月9日

2026年7月9日

WordPressのチェックサム(整合性チェック)エラー修復

はじめに

この記事では、WordPressサイトで発生したチェックサム(整合性チェック)エラーを修復するための手順について詳しく説明します。これらのエラーは通常、ファイルシステム内のデータの一貫性が失われた場合や、アップデート時に問題が発生した際に表示されます。適切な対処を行わないと、サイト全体が機能しなくなる可能性があります。

症状・背景

このテーマが必要になる主な場面:

  • WordPressのアップデート後にエラー画面が出る
  • ファイルシステム上のファイルが削除または改変された場合
  • PHPエラーログで「WordPress checksum mismatch」などのメッセージが表示される
  • サイト全体や特定ページが正しく機能しない

手順・設定方法

ステップ1: WordPressデータベースのバックアップを作成する

# データベース名、ユーザー名、パスワードを適切に変更してください。
mysqldump -u [database_username] -p[database_password] [database_name] > wp_database_backup.sql

ステップ2: WordPressのアップデートを実行する

# WP-CLIがインストールされている場合、以下のコマンドでWordPressを最新版に更新します。
wp core update --force

# アクティブテーマも更新しましょう。必要であればプラグインも同様に更新してください。
wp theme update all

ステップ3: ファイルの整合性チェックと修復を行う

# WP-CLIを使用して、ファイルの整合性を確認します。
wp core verify-checksums --path=/var/www/html/wordpress

# 整合性が合わない場合、以下のように正しいファイルに置き換えることができます。
wp core verify-checksums --force --path=/var/www/html/wordpress

ステップ4: キャッシュのクリアとサーバーの再起動

# サイト全体のキャッシュをクリアします(必要に応じて)
wp cache flush

# PHPのオペレーティングシステム上のキャッシュやtmpディレクトリもクリアする。
rm -rf /var/tmp/*

注意事項

  • ファイルのバックアップは必ず取ってから修正作業を行います。万が一、修正が失敗した場合に備えます。
  • WP-CLIを使用する前に、最新バージョンであることを確認してください。
  • サーバー上でのファイル操作には十分な注意が必要です。間違って重要なファイルを削除しないようにしましょう。

まとめ

1. バックアップ: 操作前のデータベースとファイルのバックアップは必ず取得します。

2. 更新: WordPressおよび関連テーマやプラグインの最新版に更新してください。

3. チェックサム: ファイルの整合性を確認し、必要であれば修正を行います。

4. キャッシュクリア: キャッシュをクリアすることで問題が解決することがあります。

5. 再起動: 必要な場合にはサーバーを再起動して、変更が適切に反映されるようにします。

関連記事:

お気軽にご相談ください

お見積りへ お問い合わせへ