編集画面が真っ白になる記事の直し方!ブロック起因の切り分けと修復法

編集画面が真っ白になるイメージ エラー・詰まりどころ事例

こんにちは!とも(@tomo_ITBizBlog)です!

特定の記事だけ編集画面が真っ白になって、この記事にたどり着いた方へ。書きかけの記事や、大事に育ててきた記事が急に開けなくなると、内容が消えてしまったのではないかとヒヤッとして、不安になるものです。その気持ちのまま検索して、ここに来た方も多いと思います。

先に安心材料を置いておくと、この状態は「エディタで開く時だけ落ちる」もので、公開ページの表示や記事のデータ自体は残っていることが多いです。そして原因は、記事の中に入っていた特定のブロックと環境との相性で起きるもので、書き方や操作の上手い下手とは関係ありません。当サイトでも、本館の4記事でまったく同じ状態になりました。知らないと誰でもはまるところなので、落ち着いて、順番に切り分けていきましょう。

公開ページは普通に表示されているのに、その記事だけ編集画面が開けない。

管理バーだけの真っ白な画面になって、エディタが起動しませんでした。実際に4記事で起きた症状です。

この記事では、原因だったブロックの見つけ方と、直った修復方法を実例のまま紹介します。

本記事はこんな悩みを解決!
  • 編集画面が真っ白で、記事が消えたのではないかと不安になっている
  • 特定の記事だけ編集画面が真っ白になって開けない
  • 公開ページは正常なのに、なぜ編集だけできないのか分からない
  • 原因がテーマなのか、ブロックなのか切り分けたい
この記事で分かること
  • 編集画面が真っ白になった時の症状の出方
  • 正常な記事との比較で共通ブロックを見つけた切り分け方
  • 新規挿入でも同じエラーが再現したテストの結果
  • カスタムHTMLへの変換で直した修復方法と、残った記事の扱い

編集画面だけ真っ白になった症状

公開ページは正常でも、編集画面だけ真っ白になりました
公開ページは正常でも、編集画面だけ真っ白になりました

症状が起きたのは、本館の記事4件(2606・2372・2339・1875)です。

編集画面を開くと、管理バーだけの白紙に「Cannot convert undefined or null to object」と表示され、エディタが起動しませんでした。

一方で、実害の範囲は限られていました。

  • 公開ページは正常に表示されていた
  • REST(context=view)では本文を読むことができた
  • Search Regex経由の読み書きは可能だった

つまり「記事そのものが壊れて読めない」のではなく、「エディタで開く時だけ落ちる」状態でした。緊急度は低と判断していますが、このままでは通常の編集ができません。

共通していたのはバナー風ボックスだけだった

4件にだけ共通していたブロックが、切り分けの手がかりでした
4件にだけ共通していたブロックが、切り分けの手がかりでした

慌てなくて大丈夫です。ここでやるのは、開けない記事と正常な記事を比べる作業だけで、記事の中身を書き換えることはしません。落ち着いて進めていきます。

切り分けは、正常な記事との比較から進めました。

  • 正常に開ける記事(11605・1684・1827・4513)と、ブロック構成を比べた
  • データベースの全文検索(Search Regex、検索のみ)で分布を確認した
  • 投稿のエクスポートXMLで、本文の生データを照合した

その結果、開けない4件に共通し、サイト全体でこの4件にしか存在しないブロックは、AFFINGERの「バナー風ボックス」(st-blocks/flexbox)だけでした。1875には2個、他の3件には各1個入っていました。

ブロックの開始・終了コメントは全件そろっており、個数も一致していました(XML照合済み)。属性のJSONも残っていました。

この時点では「バナー風ボックスの旧い保存形式が、現在のブロック定義と合わなくなったのではないか」という推定でした。ただし、この推定は次のテストで覆ります。

新規挿入でも再現した再現テストの結果

新しく入れたブロックでも再現したため、旧形式だけの問題ではありませんでした
新しく入れたブロックでも再現したため、旧形式だけの問題ではありませんでした

テストは新しく用意した下書きの上で行うので、開けない本番の記事には触りません。安心して読み進めてください。

推定を確かめるため、新規の下書きでテストしました。

現行のバナー風ボックスを新しく挿入して保存し、再表示しただけで、同じ白紙エラーが再現しました。

つまり、古い記事の保存形式だけの問題ではありませんでした。現在の環境では、バナー風ボックスというブロック自体がエディタを落としている、というのが実測の結論です。AFFINGER側のブロックと、WordPressやプラグイン側との不整合が濃厚と見ています。

この結果を受けて、今後の記事制作ではバナー風ボックスを使わないことにしました。直すだけでなく「もう使わない」と決めることも、再発防止として大事な結論でした。

カスタムHTMLへの変換で直した修復方法

中身のHTMLはそのままに、ブロックの形式だけを置き換えました
中身のHTMLはそのままに、ブロックの形式だけを置き換えました

修復に入る前にはバックアップを取っておくので、いきなり本番を壊すような進め方にはなりません。落ち着いて手順を見ていきましょう。

修復は、事前にエクスポートXMLでバックアップを取ったうえで進めました。

方法は、Search Regexでバナー風ボックスの開始・終了コメントを、wp:html(カスタムHTML)へ変換することです。中身のHTMLはそのまま残します。

  • 2606は1か所を変換した
  • 1875は2か所を変換した

変換後、両記事とも編集画面が開くようになりました。公開ページの表示も無事で、公開ステータスのまま維持できています。文言・リンク・画像は変更していません。

ポイントは「見た目を作っている中身は残し、エディタが読めないブロックの器だけを替える」という考え方です。記事を作り直さずに、開けない原因だけを取り除けました。

残った2記事と今後の使い方の注意点

直し方は記事ごとに分け、残りの2件は作り直しで解消する予定です
直し方は記事ごとに分け、残りの2件は作り直しで解消する予定です

4件のうち、2606と1875は修復が完了しました。残りの扱いは次のとおりです。

  • 2372と2339は未修復のままです。この2件は2021年のプライムデー記事で、セール記事の常設版へ作り直す予定があり、その作り直し(本文の全刷新)で解消する方針です
  • 2606の編集画面には、無関係の無効ブロック「チェックポイントブロック」が1か所残っています。エディタ自体は開くようになっており、この件は未対応のまま残件としています

そして、運営ルールとして残ったのが次の1点です。

  • AFFINGERのバナー風ボックス(st-blocks/flexbox)は、今後の記事制作で使わない

同じ見た目が必要な場合は、別のブロックやカスタムHTMLで代替する前提で進めます。「直せた」で終わらせず、原因ブロックを今後の制作から外すところまでが、この事例の対処です。

\ 手順を試しても直らなかった人はこちら(診断3,000円から) /

まとめ

開けない原因は記事の中身ではなく、特定のブロックでした
開けない原因は記事の中身ではなく、特定のブロックでした

編集画面が真っ白になる原因は、記事の本文そのものではなく、AFFINGERのバナー風ボックス(st-blocks/flexbox)でした。新規挿入でも再現したため、現在の環境ではこのブロック自体がエディタを落とすと判断しています。

修復は、ブロックをカスタムHTMLへ変換し、中身のHTMLをそのまま残す方法で完了しました(2606・1875)。残りの2372・2339は、セール記事常設版への作り直しで解消する予定です。

特定の記事だけ編集画面が開けない時は、記事全体の故障と決めつけず、正常な記事とブロック構成を比べてみてください。共通するブロックが、原因への近道になることがあります。

コメント

タイトルとURLをコピーしました