自動公開が成功表示なのに記事が出ない｜実行ログの確認手順

自動処理の画面に「成功」と表示されているのに、記事が公開ページに出てこない。そんなときは、緑色の成功表示だけで公開完了と判断せず、実際に投稿処理が動いたか、公開先で記事を確認できるかを分けて調べます。

私のブログで新しい記事を追加したとき、最初の自動処理は成功表示でした。事前のテスト84件もすべて成功していましたが、実行ログを読むと「新しい記事ファイルがないため何もしない」という内容で、投稿処理そのものは動いていませんでした。ファイルの検出方法を直して再実行したところ、公開状態と記事URLが返り、公開後の一覧にも記事が載りました。

この記事では、この経験をもとに、自動公開が成功扱いなのに記事が見えないときの確認順をまとめます。検索順位や訪問者数への効果を示す内容ではなく、公開処理の完了を確かめるための手順です。

「処理の成功」と「公開完了」を分ける

自動処理の「成功」は、設定された手順がエラーなく終わったという意味です。対象となる記事を見つけたことや、公開先に記事が作成されたことまで、必ず示すとは限りません。

たとえば、対象ファイルが見つからなかったときに「何もしないで終了する」仕組みでは、終了コードが正常なら実行全体は成功扱いになります。しかし、投稿処理が一度も呼ばれていなければ、公開先に新しい記事はできません。

そのため、確認する状態を次のように分けます。

これらはそれぞれ別の確認です。上の段階が成功しても、下の段階まで自動的に保証されるわけではありません。

最初に実行ログを確認する

画面の成功マークだけで終わらず、処理の詳細を開いて投稿ステップのログを読みます。まず、次のような文言がないか探してください。

• 対象ファイルがない
• 対象の記事が0件
• 条件に合うファイルがない
• 投稿処理を実行しなかった
• すでに同じ記事があるためスキップした
• 公開先への接続や認証に失敗した

「対象がないため終了」と書かれていた場合は、公開先の認証情報より先に、対象ファイルの検出条件を確認します。認証エラーが出ていないのに認証設定を変えると、原因とは関係のない変更になります。

今回も、最初のログは対象ファイルがないという内容でした。テスト結果が成功でも投稿ステップが何もしていないと分かったので、公開先の設定を触る前にファイル検出の条件を調べました。

対象ファイルの検出条件を調べる

自動処理の設定で、どの変更を「新しい記事」として扱っているかを確認します。確認する項目は次のとおりです。

1. 対象フォルダが記事の保存先と一致しているか
2. ファイル名の末尾が想定どおりか
3. 監視するブランチや更新経路が合っているか
4. 「追加されたファイル」だけを見る設定か、「変更されたファイル」も含む設定か
5. 処理が参照するイベント情報に、対象ファイル名が実際に入っているか

画面上のリポジトリにファイルが存在することと、イベント情報から自動処理がファイルを見つけられることは別です。ファイル名の条件やイベント情報をログで照合します。

私のケースでは、投稿処理が追加ファイルの一覧だけを参照していたため、実行時に対象記事が見つかりませんでした。そこで、変更前と変更後のコミットを比べ、記事フォルダ内で追加または変更されたファイルを検出する方式に修正しました。履歴を比較できるよう、チェックアウト時に十分なコミット履歴を取得する設定も追加しました。

修正後は重複投稿も確認する

検出方法を広げると、同じ記事をもう一度対象にしてしまう可能性があります。再実行や記事ファイルの修正で二重投稿が起きないよう、公開先に同じスラッグの記事があるかを先に確認します。

同じ記事がすでに存在する場合は、新しい投稿を作らず「既存記事のためスキップした」と記録する方法が安全です。スキップも成功終了にするなら、ログにその理由をはっきり残し、単に処理が何もしなかった状態と混同しないようにします。

修正後の私の実行では、テスト84件が成功し、投稿処理のログに公開状態と記事URLが記録されました。その後、公開記事の監査でも一覧への掲載を確認しました。公開先の状態とURLまで確認できたので、そこで初めて「公開済み」と判断しました。

スマホで確認するときのチェックリスト

パソコンを開けない場合も、スマートフォンの実行履歴から次の項目を順に見られます。

• 実行全体の結果だけでなく、投稿ステップの詳細を開く
• 「対象なし」「スキップ」などのログを読む
• 記事ファイル名とスラッグが一致しているか見る
• 公開先が返したステータスとURLを確認する
• 返されたURLを開き、タイトルと本文が表示されるか確かめる
• 公開記事一覧やサイト監査にも掲載されているか見る

認証情報が画面に表示される場合は、スクリーンショットを共有したり、ログをそのまま公開したりしないでください。必要なのは、秘密情報ではなく「対象が見つかったか」「投稿処理が動いたか」「公開状態が返ったか」という結果です。

よくある状況と次に見る場所

記事の状態を確認する方法は、内部リンクを修正した後に再確認した手順のように、対象と結果を分けて記録すると追いやすくなります。

まとめ

自動処理が成功表示でも、投稿処理が動いていなければ記事は公開されません。テスト、ワークフロー、投稿処理、公開先の状態、公開ページを別々に確認してください。

今回の実例では、テスト84件が成功していた一方で、最初の投稿処理は対象ファイルがないため実行されていませんでした。ファイルの検出方法を修正し、同じ記事の重複を避ける確認を加えた後、公開状態とURLを確認できました。

成功マークだけではなく、処理ログと公開先の状態まで見る。この確認を加えることで、公開したと思い込んだまま記事が出ていない状態を見つけやすくなります。