ローカルで完璧でも本番で落ちる｜WordPressプラグイン公開が2回続けて止まった原因【AI活用検証vol.130】

「ローカルで完璧に動いた」は「本番でも動く」を意味しません。AIがコードを書けるようになっても、この壁は残ります。

この検証では、2ヶ月かけて開発したWordPressプラグインが、本番リリースで2回連続して止まりました。原因はいずれもコードではなく、ZIPの作り方という配布側の問題です。失敗した経緯と具体的なエラー内容をそのまま記録します。

この検証の概要

本記事は、グループ会社である株式会社バイテックでの検証記録をもとに、当社の検証レポート形式で再構成したものです。数値・エラーメッセージ・原因の切り分けは、検証時の記録をそのまま記載しています。原文はnote の公開記事（2026年6月28日公開）をご覧ください。

結論：AIが担う範囲の外側で止まった

AIはコードを書き、ロジックを考え、採点まで担いました。しかし「ZIPの構造が正しいか」「サーバーのパス区切り文字は何か」という配布・インフラ側の知識は、AIに頼り切れない領域として残りました。

作ろうとしたシステム

もともとのフローは全て手作業でした。

受講生がLINEで成果物を送る
  → 講師が添削してフィードバック
  → 合格を運営に報告
  → 運営がFigmaで証明書を作成
  → スプレッドシートに記録
  → 受講生に連絡

1件に複数人が関わり、数日かかる

これを次のように全自動化する設計にしました。

受講生がレッスンページ内のフォームで課題を提出
  → Gemini が自動採点し、合否＋フィードバックを即表示
  → 不合格なら再提出、合格で次の課題が解放
  → レベル内の全8課題に合格
  → 担当講師を選択して証明書を発行
  → 証明書PNG 2枚を自動生成（公式デザイン）
  → Google Drive に保存＋管理シートに自動記録
  → シェア用の投稿文も自動表示

WordPress のプログラムを書いた経験はほぼない状態から、Claude Code に相談しながら構築しています。

ローカルでは全て通っていた

約2ヶ月かけて、ローカル環境での動作確認は徹底しました。

• 全246課題を実際に提出して採点させた
• 初級 → 中級 → 上級の連鎖ロック解除を確認
• 実際の受講生の提出物を使って採点精度を検証
• 証明書を実際に発行してデザインを確認

テキストだけで判定する課題と、スクリーンショット画像をAIが見て採点する課題の両方を実装しています。E2Eテストが全て完了した時点で「あとは本番に入れるだけ」という状態でした。

1回目の失敗：サイト全体がダウンした

WordPressプラグインの導入は、ZIPファイルを管理画面からアップロードするだけです。ローカルのフォルダをZIPに圧縮し、「プラグインを新規追加」→「ZIPでアップロード」を実行しました。

アップロードした瞬間、学習サイト全体がダウンしました。

class-bsc-activator.php というファイルが見つからない

該当ファイルはローカルに存在します。原因はZIPの中に includes/ フォルダが丸ごと欠落していたことでした。

Windows でフォルダを右クリック → 「圧縮」でZIPを作ると、フォルダ構造が意図どおりに入らないことがあります。今回は includes/ の中身だけが入り、フォルダ自体がZIPに含まれていませんでした。

プラグインを即削除してサイトは復旧し、ダウンから数分で戻りました。深夜に発生していた場合を考えると軽微では済まない事象です。

再挑戦の前にセキュリティレビューを実施

ZIPの問題を直す前に、ChatGPT Plus（OpenAI Codex機能）にソースコードをアップロードしてセキュリティレビューを依頼しました。5件の問題が見つかっています（記録に残っている内訳は次の4点）。

• 画像アップロードで悪意あるファイルを受け付けてしまう可能性
• 証明書が二重発行される可能性
• テスト用のコードが本番に残ったまま
• APIのシークレットキーが古いまま

全て修正し、シークレットキーも新しいものに変更してGASを再デプロイしました。ZIPの作り方も、Windows の右クリック圧縮ではなくコマンドラインで正しい構造になるよう作り直しています。

2回目の失敗：有効化で「存在しません」

構造を確認したうえでアップロードしたところ、インストール自体は成功しました。

プラグインのインストールが完了しました
　↓ 「プラグインを有効化」を押す
プラグインファイルが存在しません

インストールはできているのに、起動しようとするとメインファイルが見つからないと言われる状態です。

原因の推測は次のとおりです。Windows で作ったZIPのファイルパスは、区切り文字に「\（バックスラッシュ）」を使うことがあります。一方 Linux のサーバーは「/（スラッシュ）」しか受け付けません。ZIP展開時にパスが正しく解釈されず、ファイルの場所がずれた可能性があります。

不要な外部ライブラリを除外してパスを修正した12MBのZIPを準備した時点で、作業を一時停止しました。2ヶ月分の開発は、本番に乗らないまま止まっています。

この失敗から言えること

ローカルで動くことと本番で動くことは別

ローカル環境は自分のPCの中だけで完結します。本番サーバーはOS・PHPのバージョン・ファイル権限など、あらゆる条件が異なります。「ローカルで完璧に動いた」は「本番でも動く」を意味しません。

AIが得意な領域とインフラは別

AIはコードを書き、ロジックを考え、採点まで担えます。しかしZIPの構造やサーバーのパス区切り文字といった地味なインフラの知識は、AIに頼り切れない部分として残ります。

「AIで全自動化できた」という話の裏には、こうした作業が必ず存在します。

よくある質問

なぜ1回目でサイトがダウンしたのですか？

ZIPの中に includes/ フォルダが丸ごと欠落していたためです。プラグイン本体が includes/class-bsc-activator.php を参照するのに、展開後は class-bsc-activator.php になっており、ファイルが見つからずサイト全体が停止しました。

ZIPはどう作るべきでしたか？

Windows の右クリック圧縮ではなく、コマンドラインで構造を確認しながら作成します。右クリック圧縮ではフォルダ構造が意図どおりに入らないことがあります。

2回目の「プラグインファイルが存在しません」の原因は？

Windows のパス区切り文字「\」と、Linux サーバーが受け付ける「/」の差異が原因と推測しています。ZIP展開時にパスが正しく解釈されず、ファイルの場所がずれた可能性があります。この時点で作業を一時停止しました。

AIに任せられなかったのはどこですか？

ZIPの構造とサーバーのパス区切り文字という、配布・インフラ側の知識です。コードの実装・ロジック設計・採点精度の検証は問題なく通っていました。

採点にコストはかかりましたか？

かかっていません。Gemini の無料枠を使用する設計のため、246課題の採点コストはゼロです。

まとめ

• 2ヶ月・6コース・246課題を実装し、ローカルでは全テストを通過していた
• それでも本番導入で2回連続して停止。1回目はサイト全体がダウンした
• 1回目の原因はZIPに includes/ フォルダが含まれていなかったこと（Windows の右クリック圧縮）
• 2回目の原因はWindows の「\」と Linux の「/」というパス区切り文字の差異と推測
• 再挑戦前のセキュリティレビューで5件の問題を検出。二重発行やテストコードの残存など
• ローカルで動く ≠ 本番で動く。OS・PHPバージョン・ファイル権限が異なる
• AIはコードを書けるが、ZIP構造やパス区切り文字といったインフラ側は残る

自動化の難所は、しばしばロジックではなく配布と環境差にあります。AIが実装を担うほど、この領域が相対的に大きな比重を占めるようになります。

株式会社AI棒では、こうしたAI活用の検証を日々行い、企業の開発体制へのAI導入を支援しています。ご相談はお問い合わせフォームから、継続的な伴走支援についてはAI参謀をご覧ください。