はじめに
この記事では、WordPressが動作中に「Unknown column」データベースエラーメッセージを表示する問題について詳しく説明します。このエラーはデータベースのカラム（列）に関するもので、通常はインストールや更新時に発生しやすくなります。
症状・背景
このテーマが必要になる主な場面:
- WordPressのアップデート中に発生
- テーマやプラグインをインストールまたは有効化した直後
- データベースコマンドを直接実行してデータベーススキーマを変更した場合
- バックアップと復元作業後の不整合
手順・設定方法
ステップ1: エラーメッセージの確認
エラーログやウェブブラウザを通じて表示される「Unknown column」エラーは、具体的なテーブル名とカラム名と共に記載されます。まずはその情報を確実に把握してください。
# サイトのエラーログを確認します。
tail -f /var/log/apache2/error.log
# データベースコマンドでエラーが発生したテーブルとカラム名を特定します。
mysql -u root -p yourdbname -e "SELECT * FROM wp_yourtablename"ステップ2: カラムの存在確認と追加
確認したカラム名が見つからない場合、そのカラムは既存テーブルから削除されているか、またはWordPressの最新バージョンに合わせて変更された可能性があります。次のコマンドで確認し、必要であれば適切なカラムを追加します。
# テーブルスキーマを表示してカラムの存在を確認します。
mysql -u root -p yourdbname -e "DESC wp_yourtablename"
# カラムが見つからない場合は、該当するカラムを追加します。
ALTER TABLE wp_yourtablename ADD COLUMN column_name datatype;ステップ3: テーマやプラグインのコンフリクト対応
特定のテーマやプラグインがこのエラーを引き起こしている可能性があります。一度無効化してみて、問題が解決するかどうか確認します。
# プラグインを一時的に無効にします。
wp plugin deactivate yourpluginname
# システムテーマを使用して現在のアクティブテーマを一時的に変更します。
wp theme switch --theme=twentytwentyoneステップ4: 完全なデータベースバックアップと復元
最悪の場合、完全なデータベースバックアップから復元することで問題を解決することがあります。ただし、この操作は注意が必要です。
# データベースのバックアップを取得します。
mysqldump -u root -p yourdbname > yourdb_backup.sql
# バックアップファイルからデータベースを復元します。
mysql -u root -p yourdbname < yourdb_backup.sql注意事項
- カラム追加やテーブル構造の変更は、WordPressサイトが完全に停止していることを確認した上で行うことが推奨されます。
- データベース操作は必ず復元可能なバックアップを取った上で行い、誤った操作によるデータ損失を防ぎましょう。
- 安定性や互換性の観点から、最新バージョンのWordPressテーマとプラグインを使用することが重要です。
まとめ
1. 確認: エラーメッセージに含まれるテーブル名とカラム名を正確に特定します。
2. 調査: テーブルスキーマから該当するカラムが存在することを確認します。
3. 修正: 必要であれば、欠落しているカラムを追加または再作成します。
4. テスト: 実施した修正で問題が解決したか再度確認します。
5. バックアップ: すべての変更前にデータベースの完全なバックアップを作成します。
関連記事: