​
代表的なエラー

src/firebase.js の構成値がFirebase Consoleと一致しているか確認。Authorized domainsに app.hirameki-web.com を追加。
/var/www/grav-sites/ への書き込み権限があるか確認。ディスク容量も確認してください。
PostgreSQL接続を確認。users テーブルにFirebase UIDが登録されているかチェック。
ファイルサイズ (10MB以内) と拡張子 (jpeg/png/webp/gif) を確認。Nginxの client_max_body_size が十分か確認。

​
デバッグコマンド

# バックエンドログ
pm2 logs ai-web-builder

# プロセス再起動
pm2 restart ai-web-builder

# プロセス状態確認
pm2 list

# データベース接続確認
psql -c 'SELECT NOW();' hirameki_web

# Nginx設定テスト
nginx -t

# SSL証明書確認
certbot certificates

​
AI プロバイダー切り替え

AI_PROVIDER 環境変数で切り替え可能: 
# Gemini (デフォルト)
AI_PROVIDER=gemini

# Claude
AI_PROVIDER=claude
変更後は pm2 restart ai-web-builder が必要です。 Claude使用時にHTTP 5xxエラーが発生した場合、自動的にGeminiにフォールバックします（非ストリーミング時のみ）。
問題が解決しない場合は pm2 logs ai-web-builder --lines 100 でエラーログを確認してください。