問題のトラブルシューティング

1. アプリのダッシュボードに移動します。
2. Overview をクリックします。
3. App Visibility の下で Public を選択します。

1. パブリックランディングページ用に別のアプリを作成します。
2. 両方のアプリを公開します。
3. このランディングアプリをメインのプライベートアプリにリンクします。
4. プライマリドメインをランディングページアプリに、サブドメインをプライベートアプリに割り当てます。

• AI にパブリックランディングページを作成するよう依頼し、すべてのユーザーのデフォルトに設定します。
• 他のすべてのページを RLS で保護します(ログインしたユーザーのみが表示できるように)。
• リダイレクトを設定します: ログアウトしている人はランディングに送られ、ログインしているユーザーはダッシュボードに送られます。
• プロンプトの提案:
  “Please implement a landing page for our app that allows users to login/signup at /Login utilizing our existing theme. Make sure all pages except the landing page are secured behind RLS and that logged-in users can’t access the landing page but are redirected to the dashboard.”

1. チャットメッセージの Revert アイコンをクリックして、アプリを以前の動作するバージョンに戻します。
2. Version History(AI チャットの時計アイコン)を開き、何かをクリックしても白い画面にならなかった古いバージョンにロールバックします。
3. 問題が表示される場所、時刻、方法など、より具体的な詳細を AI チャットに説明してみてください。

1. 最新のサポートされているブラウザを使用していることを確認します。
2. ブラウザのキャッシュと Base44 のクッキーをクリアします。
3. ブラウザの拡張機能、特に広告ブロッカーやプライバシーツールを無効にします。
4. シークレットウィンドウでエディタを開くか、別のブラウザを試します。
5. 報告されている障害について Discord のコミュニティを確認します。
6. エディタがまだ動作しない場合は、エラー(特にブラウザのコンソールから)のスクリーンショットを撮り、ブラウザとオペレーティングシステムの詳細とともに Base44 サポートに連絡してください。

1. ブラウザとデバイスのキャッシュをクリアし、アプリを再読み込みします。
2. 別のブラウザまたはデバイスからアプリを再確認します。
3. Publish をクリックして “success” メッセージが表示されたことを確認します。
4. バックエンド関数を更新した場合は、ダッシュボードから再デプロイします。
5. Base44 ダッシュボードでエラーログを探します。
6. 何も機能しない場合は、Base44 サポートに連絡する際にアプリのリンクと不足している内容の詳細を含めてください。

ヒント: アプリのコードと設定がエディタで正しく見えるのにライブアプリが空白の画面や更新の欠落を示す場合、フィールドスキーマと保存されたデータを再確認してください。隠れたスキーマの不一致は一般的な原因です。

1. チャットを開始する前に、AI チャットウィンドウで Discuss をクリックします。Discuss ボタンがハイライトされているはずです。
2. アイデアを計画し、質問し、AI と話し合います。
3. 議論を終え、AI にアクションや何かの構築をしてもらう準備ができたら、もう一度 Discuss をクリックしてオフにします。Discuss ボタンはハイライトされなくなり、AI に変更を実装するよう依頼できます。

1. AI チャットで Visual Edit と Discuss をクリックします。
2. 作業したいアプリプレビュー内の要素(ボタン、フォーム、入力、テーブル行など)をクリックします。
3. 要素で Discuss をクリックして、そのコンポーネントにリンクされた集中したチャットを開きます。
4. AI チャットで、何が起きているか、何が起きるべきかを説明します。

1. チャットメッセージの Revert アイコンをクリックするか、正しく動作していたアプリの最後のバージョンに戻ります。これは AI の状態をリセットし、しばしば問題を解決します。
2. ‘thinking’、‘applying changes’、‘undoing’ などの状態でチャットが詰まっている場合は、チャットの Stop ボタンをクリックします。
3. AI リクエストが非常に長いか複雑な場合は、より小さく管理しやすい部分に分割します。これは AI があなたの指示を正確に処理するのに役立ちます。
4. ブラウザを更新し、インターネット接続を確認します。
5. ブラウザのキャッシュをクリアし、スクリプトをブロックする可能性のあるブラウザ拡張機能をオフにします。
6. プライベートまたはシークレットウィンドウでアプリを開きます。
7. それでも動作しない場合は、報告されている問題について Discord を確認してください。
   チャットの処理状態が 10 分以上続くか、更新が提供されない場合は、Stop ボタンをクリックし、以下の詳細を含めてサポートチームに知らせてください:

   • AI が詰まった場所(アプリ内の場所または関数)
   • 実行していたプロンプトまたはアクション
   • 処理状態がどれくらい続いたか

1. エラーが提案するように、最後のメッセージを元に戻します。
2. ページを完全に更新します:
   • Windows または Linux では Ctrl + Shift + R または Ctrl + F5 を押します。
   • Mac では Cmd + Shift + R を押します。
3. チャットセクションをクリアして新しいプロンプトを開始してみます。
4. エラーが続く場合は、プロンプトとエラーの詳細を含めてサポートにご連絡ください。

1. アプリの Dashboard に移動します。
2. Settings に移動して App settings を選択します。
3. Clone app をクリックします。
4. クローンしたアプリを開きます。

1. 元のプロンプトテキストをコピーします。
2. 新しいアプリを作成します。
3. 同じプロンプトを AI チャットに貼り付けて再度実行します。

1. アプリのダッシュボードに移動し、Security をクリックします。
2. Start security check をクリックして、不足または誤って構成された RLS ルールをスキャンします。
3. 見つかった問題を確認し、推奨される安全なデフォルトを使用するには Apply Fixes をクリックするか、各データエンティティのルールを手動で調整します。
4. 異なるユーザーロールでサインインして、各種類のデータに権限のある人だけがアクセスできることを確認します。

1. ページを更新するか、後で再度試してください。一部の 500 エラーは一時的なものです。
2. ステータスページまたは Discord チャンネルを確認して、既知のプラットフォームインシデントがあるかどうかを確認してください。

• アプリ名
• エラーがどこで、いつ発生するか
• コンソールからのエラーメッセージ(可能であればスクリーンショット)
• 問題に至った手順

• アプリが一瞬読み込まれて消える。
• アプリのリンクをクリックすると、白いページまたは読み込みホイール以外何も表示されない。
• 一部のページ、タブ、または機能が凍結して応答しない。
• ボタンをクリックしたり選択したりするとアプリがクラッシュする。
• ダッシュボード、プレビュー、または主要ページにアクセスしようとしても何も表示されない。

1. ページを更新するか、新しいブラウザウィンドウでアプリを開きます。
2. ブラウザのキャッシュとクッキーをクリアして、再度読み込んでみます。
3. インターネット接続が安定していることを確認します。
4. ブラウザまたはデバイスを切り替えて、問題が他の場所でも続くかどうかを確認します。
5. 問題が発生する前に最近編集した場合は、可能であれば最新の変更を元に戻してみます。
6. 数分待ちます。プラットフォームが更新中または一時的なダウンタイムが発生していることがあります。

• 表示されている内容の説明(空白のページ/スピナーなど)
• 問題が始まった時期と、最近行った編集
• アプリ名またはリンク
• ブラウザコンソールに表示されているエラーメッセージ(可能であれば)

1. Version History を使用して、詰まったプロンプトの前にアプリを素早く戻します。これは以前の状態に戻る最速の方法です。
2. アプリ設定で LLM を変更し、Discuss モードに切り替え、何かプロンプト(例: “hi”)を送信して詰まった状態を解除します。
3. Visual Edit モードを使用して、余分なスペースを追加したりテキストを更新するなど、小さな変更を加えて状態変更を強制します。
4. 可能であれば、モバイルデバイスでアプリを開き、Discuss モードを有効にして、プロンプトを送信します。

1. チャット履歴のすべてのプロンプトには Revert ボタンがあります。これをクリックして、その変更の直前までアプリをロールバックします。
2. チャットで AI に “頼んで” アプリをロールバックしても、実際にはプロンプトの変更は元に戻りません。Revert ボタンまたは Version History だけが修正できます。
3. Revert ボタンが機能しない場合は、Version History(通常ダッシュボードまたはプレビューの近くにあります)を使用します。これにより、以前のアプリバージョンに復元できます。
4. Revert と Version History の両方が機能しない場合は、さらなるサポートのために Base44 サポートに連絡してください。

• アプリへのリンク
• 影響を受けているバックエンド関数名のリスト(例: ebayAuth)
• 各エンドポイントでの 404 エラーを示すスクリーンショット
• 問題が始まった時期(デプロイ、移行、プラットフォーム更新の後など)

1. サービスにログインします。
2. API または開発者セクションに移動します。
3. キーを生成します。
4. それを Secret として Base44 に貼り付けます。

• GET リクエストは、URL のクエリ文字列でデータを渡すことができます。
• POST リクエストは、リクエストボディでデータを安全に送信できます。

1. Deno.serve エントリポイントの欠如: /functions フォルダ内の各関数ファイルは、エントリポイントとして Deno.serve() を使用する必要があります。例: Deno.serve((request) => { ... })
2. /functions 内のユーティリティファイルまたは空のファイル: /functions フォルダ内のユーティリティモジュールまたは完全に空のファイルは、実際のエンドポイントを意図していなくてもこのエラーをトリガーする可能性があります。ヘルパーファイルは /functions の外に移動するか、デプロイから除外する必要があります。
3. 無効なインポート: バックエンド関数は自己完結している必要があります。サポートされている npm パッケージからのインポートのみを保持してください。以下をインポートしないでください:

• フロントエンドコンポーネント
• 他のフォルダからの共有プロジェクトユーティリティ
• 他のバックエンド関数を直接

4. サポートされていない API: Deno ランタイムは一部の Node.js 組み込みやブラウザ専用 API をサポートしていません。次のものを削除または置き換えてください:

• fs、path、process、crypto などの Node.js モジュール
• DOM または window ベースのブラウザ API

1. エントリポイントを確認: バックエンド関数としてデプロイされる /functions 内のすべてのファイルが、エントリポイントとして Deno.serve() ブロックを定義していることを確認します。
2. /functions フォルダをクリーンアップ
   • 関数としてデプロイすべきでない空のファイルや純粋なユーティリティモジュールを削除または移動します。
   • 実際の関数ファイルだけが /functions にあることを確認します。
3. インポートと API を修正
   • フロントエンドコンポーネント、共有ユーティリティ、または他のバックエンド関数のローカルインポートを削除します。
   • サポートされていない Node.js またはブラウザ固有の API をサポートされている代替に置き換えます。
   • サポートされている npm パッケージからのインポートのみを保持します。
4. 保存して公開: 変更を保存してアプリを公開し、バックエンド関数を再構築・再デプロイできるようにします。
5. Base44 AI に関数のリファクタリングを依頼: それでもエラーが表示される場合は、関数コードを Base44 AI チャットにコピーして、次のように言ってください: “This backend function returns ISOLATE_INTERNAL_FAILURE. Make it self contained and compatible with Deno.serve without changing what it does.” AI は、ロジックを同じに保ちながら、関数が正しい Deno パターンに従うように書き直すのを手伝うことができます。

1. アプリダッシュボードに移動します。
2. 右上の Publish をクリックします。
3. アプリがまだ公開されていない場合は Publish app を選択します。

1. アプリダッシュボードで Overview をクリックします。
2. App visibility で、アプリにアクセスできる人に応じて Public (No login required) または Public (Login required) を選択します。
3. アプリが Private (Base44 login required) に設定されている場合、明示的に招待したメールアドレスだけがリンクを開けます。

1. デフォルトの Base44 アプリ URL の代わりにカスタムドメインを使用している場合、Base44 設定でドメインが接続され検証されていることを確認します。
2. デフォルトの Base44 アプリ URL を直接開いて、アプリ自体が期待通りに読み込まれることを確認します。

1. ドメインの AAAA(IPv6)レコードを削除します。これらは適切なセットアップを妨げる可能性があります。
2. インターネット全体で変更が完全に伝播するまで 48〜72 時間待ちます。
3. whatsmydns.net などのツールを使用して、更新されたレコードが世界中で見えることを確認します。
4. 正確なレコード値を入力したことを再確認します。
5. 約 30 分経過してもステータスがまだ pending の場合、Base44 でドメインのリンクを解除して、再度追加してみてください。

• DNS レコードのスクリーンショット
• ドメイン名
• Base44 アプリのリンク

1. IONOS のメールを開き、リンクをクリックしてメールアドレスを確認します。
2. Base44 で、アプリのダッシュボードに移動し、Domains をクリックし、ドメインを選択し、Unlink domain をクリックします。
3. ドメインを再度接続します。
4. 接続が完了するまで数分待ちます。

• DNS レコードが、お使いのセットアップタイプについてこのガイドに表示されているものと正確に一致することを確認します。
• **AAAA(IPv6)**レコードを削除します。これらは接続をブロックする可能性があります。
• タイプミスを再確認します。このガイドから値を正確にコピー & ペーストしてください。
• www とルートドメインの両方が正しく設定されていることを確認します。
• ドメインが更新されアクティブであることを確認します。
• 変更が反映されるまで最大 72 時間待ちます。

• CNAME および ANAME/ALIAS レコード要件を再確認します:
  • www → base44.onrender.com(CNAME)
  • root / @ → base44.onrender.com(ANAME/ALIAS、ANAME/ALIAS がサポートされていない場合は A レコード)
  • A レコードを使用する場合、@ → 216.24.57.1 に設定します
• AAAA レコードを削除します。Base44 は IPv4 のみをサポートしており、AAAA レコードはドメイン解決を壊す可能性があります。
• IONOS ドメインの場合、ほとんどの問題を解決するためにドメインのリンク解除と再リンクを試してください。
• 完全な DNS 伝播後もこれらの手順を試して問題が続く場合は、サポートに連絡してください。

• ドメインの DNS レコードが、Base44 ダッシュボードに表示されているものと正確に一致することを確認します。
• DNS 設定から AAAA(IPv6)レコードを削除します。これらは安全な接続をブロックする可能性があります。
• DNS エントリのタイプミスや欠落した値を慎重に確認します。
• www とルートドメインの両方が正しい Base44 IP アドレスまたは CNAME を指していることを確認します。
• ドメインの登録がアクティブで確認済みであることを確認します。
• DNS と SSL の変更が世界中に完全に伝播するまで最大 72 時間待ちます。
• Cloudflare のような DNS サービスを使用している場合、そのサービス内で直接レコードを更新し、セットアップやトラブルシューティング中は Base44 関連のレコードを DNS only(灰色の雲)に設定します。

• 現在の DNS レコードのスクリーンショット
• ドメイン名
• Base44 アプリへのリンク

1. 受信トレイ、スパム、迷惑メールフォルダで IONOS からのメールを確認します。
2. メールが見つからない場合は、IONOS(ドメインレジストラ)に連絡して新しい認証メールをリクエストします。
3. IONOS に連絡する際は、ドメイン名を提供し、ドメインの購入後に認証メールを受信していないことを説明します。
4. IONOS からの手順に従って、ドメイン認証を完了します。

1. パブリック DNS ルックアップツールを開き、ドメインの A レコードを検索します。
2. そこに表示されている IP をレジストラの DNS ゾーン内の A レコードと比較し、1 つの IP がパブリックツールでのみ表示されることを確認します。
3. ドメインレジストラのアカウントにサインインし、ドメインの管理ページを開きます。
4. Domain forwarding、URL redirect、Web forwarding、または Parking という名前のセクションを探します。
5. ドメインで転送、リダイレクト、またはパーキングオプションがオンになっている場合は、オフにするか削除して、変更を保存します。
6. 余分な IP がどこから来ているかわからない場合は、DNS ツールから IP アドレスをコピーし、それに対して WHOIS ルックアップを実行します。
7. IP がレジストラ(GoDaddy や Namecheap など)に属する場合、ほぼ確実にデフォルトのパーキングまたは転送ページです。このドメインのすべての転送とパーキング機能が完全に無効になっていることを確認します。
8. DNS の変更が伝播するのを待ってから、ドメインの接続または SSL ステータスを再度確認します。

1. 動画がサポートされている形式(MP4、WEBM、MOV、AVI、MKV、M4V、WMV、OGV、3GP、3G2)のいずれかであることを確認します。
2. 動画が 1 つあたり 100MB 以下であることを確認します。
3. 動画を再度アップロードしてみます。
4. アップロードがまだ機能しない場合は、エディタを更新して再試行します。

1. ファイルがサポートされている形式のいずれかであることを確認します。
2. ファイルがそのファイルタイプのサイズ制限を超えていないことを確認します。
3. 誤って間違ったファイルをアップロードした場合は、メッセージの Revert をクリックして最後のプロンプトを元に戻します。
4. サポートされている形式を使用してファイルを再度アップロードしてみます。

1. 特に画像のアップロードが前のステップだった場合は、最後のメッセージを元に戻します。
2. 画像エディタでファイルを開き、ファイル拡張子を単に名前変更するのではなく、PNG、JPG、JPEG などのサポートされている形式で再保存またはエクスポートします。
3. ファイルが AI チャットの制限を満たしていることを確認します。
4. サポートされている形式を使用して、新しくエクスポートされた画像を再度アップロードしてみます。

• 必須フィールドが欠落しているフォームの送信。
• 間違ったデータ形式で API を呼び出す。

• サインインせずにダッシュボードページを表示しようとする。
• 無効な認証情報または期限切れのトークンで API または連携機能を呼び出す。

• アクセス権のないアプリで設定を変更しようとする。
• アプリのロールまたは RLS ルールによって制限されたデータまたはページにアクセスしようとする。

• 認証情報を送信できないサービスのために、Webhook エンドポイントが認証を必要としないことを確認します。エンドポイントはこれらの種類の連携で動作するためにパブリックでなければなりません。
• 他の連携の認証を維持したい場合は、これらのサービス用に別のパブリック専用の関数またはエンドポイントを設定し、機密でないアクションにのみ使用します。

• アプリまたはダッシュボードの不正な URL を入力する。
• 削除または移動されたファイルにアクセスする。

• ドメインを再接続したり、ダッシュボードで同じアクションを繰り返すのを素早くクリックする。
• API、バックエンド関数、またはオートメーション経由で短期間に多くの繰り返しリクエストを送信する。

• レート制限は人ごとに適用されるため、容量はアプリを使用する人数に応じてスケールします。
• すべてを一度に送信するのではなく、リクエストを時間をかけて分散させます。
• 連携がサポートしている場合は、バッチリクエストを使用します。
• 同じデータについて同じエンドポイントを何度も呼び出さないように、キャッシュを追加します。
• 429 応答の後、少し待って新しいリクエストを送信する再試行ロジックを追加します。
• 通常のアクティビティ中に 429 エラーが表示される場合は、エラーの時刻と試みた内容を添えて Base44 サポートに連絡してください。

• “500 Internal Server Error” ページが表示される。
• データの保存または読み込み時に機能が失敗する。