メインコンテンツへスキップ
見出し画像
Photo bygolchiki

WordPress移行事件簿 File.001 ― 消えた管理者権限の謎

    管理者なのに「このページにアクセスする権限がありません」。犯人は権限設定か、プラグインか。それとも……。

    WordPressサイトの移行は、これまで何度も経験してきた。Virtualminで仮想サーバーを移し、WordPress側はAll-in-One WP Migrationのバックアップから復元する。慣れた手順だ。

    ところが今回、移行先でログインするとサイトのトップページが表示され、管理画面へ進めない。/wp/wp-admin/ を直接開くと、こう表示された。

    「このページにアクセスする権限がありません。」

    いや、管理者なんですが。

    こうして、ちょっとした技術事件の捜査が始まった。

    第1章:閉ざされた管理画面

    移行先はAlmaLinux+Virtualmin+MariaDB。WordPressは /wp/ に設置し、サイトはドメイン直下で公開している。

    普段の移行手順はこうだ。

    1. 移行元のWordPressでAll-in-One WP Migrationのバックアップを取得

    2. Virtualminで仮想サーバーを移行

    3. 移行先のWordPress管理画面にログイン

    4. All-in-One WP Migrationでバックアップをリストア

    5. 表示・ログイン・プラグインを確認

    今回つまずいたのは3番。バックアップはあるのに、復旧ツールを動かす管理画面へ入れない。修理道具は家の中、玄関の鍵が開かない状態だ。

    第2章:容疑者を一人ずつ調べる

    まずシークレットウィンドウで試したが変化なし。URL設定も確認した。

    設定 値 home https://km-example.jp siteurl https://km-example.jp/wp

    この構成なら不自然ではない。

    次にプラグインを一時的に無効化したが、症状は変わらなかった。通常のプラグインが直接の原因である可能性は低そうだ。

    さらにMariaDBで管理者ユーザーのメタ情報を確認すると、意外なことに正常だった。

    wp_capabilities = a:1:{s:13:"administrator";b:1;}
    wp_user_level   = 10

    管理者権限はデータベースに存在する。それなのにWordPressは管理画面を拒否する。どういうことだろう。

    第3章:管理者なのに、管理者ではない

    VirtualminのターミナルからWordPressを読み込み、admin ユーザーの権限を調べた。なお、当時のCLI版PHPは7.4.33だった。

    require 'wp-load.php';
    
    $user = get_user_by('login', 'admin');
    echo 'Roles: ' . implode(',', $user->roles) . PHP_EOL;
    echo 'Can manage_options: ' . ($user->has_cap('manage_options') ? 'YES' : 'NO') . PHP_EOL;

    結果はこうだ。

    Roles:
    Can manage_options: NO

    データベースには管理者権限があるのに、WordPressは管理者として認識していない。

    ユーザーごとの wp_capabilities だけでなく、ロールそのものの定義を調べる必要がありそうだ。

    第4章:消えた administrator

    WordPressのロール定義は、通常 wp_options テーブルの wp_user_roles に保存されている。

    SQLで見るとレコードは存在する。冒頭には administrator の定義もある。ところがWordPress内部で確認すると、結果は驚くべきものだった。

    Administrator exists: NO

    さらに get_option('wp_user_roles') の戻り値を調べると、配列ではなく boolean。データベースから生の値を取得して maybe_unserialize() しても、やはり boolean になった。

    Raw data length: 6439
    Unserialized type: boolean
    Object cache enabled: NO

    ロール定義のシリアライズデータが正常に復元できない。 これなら、ユーザーに administrator と書かれていても権限判定が失敗する説明がつく。

    第5章:MariaDBの文字コードという伏線

    移行元の同じデータを確認すると、サイズが異なっていた。

    比較項目 移行元 移行先 wp_user_roles のデータ長 6,473バイト 6,439バイト PHPによる復元 未検証 失敗

    そして、環境の違いが判明した。

    移行元MariaDBは latin1、移行先は utf8 系。

    PHPのシリアライズ形式は、文字列の長さを「文字数」ではなく「バイト数」で記録する。

    s:6:"Sample";

    日本語などの文字列が変換され、実際のバイト数と記録された長さが食い違うと、復元に失敗することがある。

    今回も、移行時の文字コード変換が不整合を生んだ可能性が高い。ただし、バイト数の差だけで原因が証明されたわけではない。確認できた事実は「移行先の wp_user_roles を復元できなかった」こと。変換のどの工程で破損したかまでは追跡していない。

    ここは推理と証拠を分けておきたい。事件簿なので。

    第6章:管理者権限を奪還せよ

    目的は、データベース全体を手作業で修復することではない。まず管理画面へ入れるようにして、普段どおりAll-in-One WP Migrationで復元することだ。

    最初に、問題のロール定義を別テーブルへバックアップした。

    CREATE TABLE wp_options_backup_roles_20261029 AS
    SELECT *
    FROM wp_options
    WHERE option_name = 'wp_user_roles';

    バックアップが1件あることを確認したうえで、VirtualminのターミナルからWordPress標準のロールを再生成した。

    cd ~/public_html/wp
    
    php -r '
    require "wp-load.php";
    require_once ABSPATH . "wp-admin/includes/schema.php";
    populate_roles();
    '

    注意: これは実際に復旧に使用したコマンドの記録であり、あらゆる環境での万能な修復策ではない。既存ロールやプラグイン独自の権限定義に影響する可能性があるため、実行前のバックアップと影響確認が必要だ。特に本番環境では安易に実行しないでほしい。

    実行後、権限を再確認した。

    Roles: administrator
    Can manage_options: YES

    管理者、帰還。

    ブラウザで管理画面を開くと、ついに正常表示された。

    第7章:本当のリストアはここから

    管理画面に入れたので、ようやく本来の手順に戻れた。All-in-One WP Migrationから、移行元で取得しておいたバックアップをリストアする。

    リストア完了後、次の項目を確認した。

    確認項目 結果 バックアップからのリストア OK 日本語の文字化け なし 管理画面への再ログイン OK プラグインの動作 OK サイト表示 OK

    すべて正常。事件は無事解決した。

    これまでの移行では、All-in-One WP Migrationによる復元が文字コードの違いをうまく扱ってくれていたようだ。今回だけは、その復元処理を始めるための管理画面が先に壊れてしまった。

    消防車はあった。車庫のシャッターが開かなかっただけなのだ。

    最終章:今回の教訓

    今回の経験から、覚えておきたいことは3つある。

    1. ログイン認証の成功と、管理者権限の認識は別。 wp_capabilities が正しくても、ロール定義を読めなければ管理画面に入れない。

    2. MariaDBの文字コードが異なる環境への移行では、シリアライズデータに注意。 単純な文字コード変換や文字列置換では、内部に記録されたバイト長まで整合するとは限らない。

    3. 復旧ツールへ入るための最小限の修復が有効な場合がある。 今回はロール定義を再生成して管理画面を開き、バックアップからのリストアで最終的に正常化できた。

    何度もWordPressを移行してきたが、このケースは初めてだった。

    エラーメッセージは「このページにアクセスする権限がありません」。

    たしかに、その時点では権限がなかった。

    でも、管理者が権限を失ったのではない。

    WordPressが、管理者を管理者として認識できなくなっていたのだ。

    同じ症状に遭遇した誰かの捜査の手掛かりになれば幸いだ。

    WordPress移行事件簿 File.001 ― 完 ―


    本記事は実際の移行トラブルの記録です。文字コード変換が破損を引き起こした具体的な工程までは特定していません。コマンドは環境に合わせて読み替え、データベースを変更する前には必ずバックアップを取得してください。

    おまけ

    普段は X で、Claude Code や VPS 運用、個人開発の試行錯誤について発信しています。よかったらフォローしてください 👇
    X: @kumapress1
    質問や「こんなハマり方したよ」みたいな話もお待ちしてます。

     
     
    まもなく還暦な子供3人の現役プログラマーです。学生時代は紙テープでプログラム作ってました。。もうほとんど博物館ww長く一人で法人をやってますんで、いまは、インフラからWebサービス、アプリ開発まで一人で対応しています! ここでは生活の中でハマったことなどを投稿させていただきます!

    あなたへのおすすめ