351 lines
8.3 KiB
Markdown
351 lines
8.3 KiB
Markdown
# トラブルシューティング
|
|
|
|
9Router利用時の一般的な問題と解決策。
|
|
|
|
---
|
|
|
|
## "Language model did not provide messages"
|
|
|
|
**問題:** リクエストが空のレスポンスまたはエラーメッセージで失敗。
|
|
|
|
**原因:**
|
|
- プロバイダーのクォータが消費された
|
|
- APIキーが無効または期限切れ
|
|
- モデルが利用不可
|
|
|
|
**解決策:**
|
|
|
|
1. **クォータ状況を確認:**
|
|
```
|
|
Dashboard → Providers → クォータトラッカーを表示
|
|
```
|
|
クォータが消費されている場合、リセットを待つかプロバイダーを切替。
|
|
|
|
2. **コンボフォールバックを使用:**
|
|
```
|
|
Dashboard → Combos → フォールバックチェーンを作成
|
|
例: cc/claude-opus → glm/glm-4.7 → if/kimi-k2
|
|
```
|
|
|
|
3. **プロバイダー接続を確認:**
|
|
```
|
|
Dashboard → Providers → 必要に応じて再接続
|
|
```
|
|
|
|
---
|
|
|
|
## レート制限
|
|
|
|
**問題:** 「Rate limit exceeded」または「Too many requests」エラー。
|
|
|
|
**原因:**
|
|
- サブスクリプションのクォータが枯渇(5時間/日次/週次の制限)
|
|
- APIレート制限に達した
|
|
- 同時リクエストが多すぎる
|
|
|
|
**解決策:**
|
|
|
|
1. **リセット時間を確認:**
|
|
```
|
|
Dashboard → Quota Tracking → リセットカウントダウンを表示
|
|
```
|
|
|
|
2. **低価格階層へ切替:**
|
|
```
|
|
使用: glm/glm-4.7 (100万トークンあたり$0.6)
|
|
minimax/MiniMax-M2.1 (100万トークンあたり$0.20)
|
|
```
|
|
|
|
3. **フォールバックコンボを追加:**
|
|
```
|
|
Dashboard → Combos → バックアップモデルを追加
|
|
優先: cc/claude-opus (サブスクリプション)
|
|
バックアップ: glm/glm-4.7 (低価格)
|
|
緊急時: if/kimi-k2 (無料)
|
|
```
|
|
|
|
---
|
|
|
|
## OAuthトークン期限切れ
|
|
|
|
**問題:** 「Unauthorized」または「Token expired」エラー。
|
|
|
|
**原因:**
|
|
- OAuthトークンが期限切れ(自動更新失敗)
|
|
- プロバイダーセッションが無効化された
|
|
- 更新中のネットワーク問題
|
|
|
|
**解決策:**
|
|
|
|
1. **自動更新(デフォルト):**
|
|
9Routerは自動的にトークンを更新します。30秒待ってから再試行。
|
|
|
|
2. **手動で再接続:**
|
|
```
|
|
Dashboard → Providers → [プロバイダー名] → Reconnect
|
|
→ OAuthフローを再度完了
|
|
```
|
|
|
|
3. **プロバイダーステータスを確認:**
|
|
プロバイダーサービスがオンラインであることを確認(Claude Code、Codexなど)
|
|
|
|
---
|
|
|
|
## 高コスト
|
|
|
|
**問題:** 予期しない高使用量またはコスト。
|
|
|
|
**原因:**
|
|
- 不必要に高価なモデルを使用
|
|
- 低価格階層へのフォールバックがない
|
|
- 大きなコンテキストウィンドウ
|
|
|
|
**解決策:**
|
|
|
|
1. **使用統計を確認:**
|
|
```
|
|
Dashboard → Usage Stats → トークン消費量を表示
|
|
→ 高コストモデルを特定
|
|
```
|
|
|
|
2. **より安いモデルへ切替:**
|
|
```
|
|
置換: cc/claude-opus (月$20〜100サブスクリプション)
|
|
へ: glm/glm-4.7 (100万トークンあたり$0.6)
|
|
minimax/MiniMax-M2.1 (100万トークンあたり$0.20)
|
|
```
|
|
|
|
3. **無料階層を使用:**
|
|
```
|
|
if/kimi-k2-thinking (無料)
|
|
qw/qwen3-coder-plus (無料)
|
|
kr/claude-sonnet-4.5 (無料)
|
|
gc/gemini-3-flash-preview (月18万無料)
|
|
```
|
|
|
|
4. **プロンプトを最適化:**
|
|
- コンテキストサイズを削減
|
|
- 長い応答にストリーミングを使用
|
|
- 一般的なプロンプトをキャッシュ
|
|
|
|
---
|
|
|
|
## Connection Refused
|
|
|
|
**問題:** 「ECONNREFUSED」または「Cannot connect to localhost:20128」。
|
|
|
|
**原因:**
|
|
- 9Routerが起動していない
|
|
- ポート20128がブロックされている
|
|
- ファイアウォールが接続をブロック
|
|
|
|
**解決策:**
|
|
|
|
1. **9Routerを起動:**
|
|
```bash
|
|
9router
|
|
```
|
|
ダッシュボードがhttp://localhost:3000で開くはず
|
|
|
|
2. **ポート20128を確認:**
|
|
```bash
|
|
# ポートがリッスンしているか確認
|
|
lsof -i :20128
|
|
|
|
# またはWindowsで
|
|
netstat -ano | findstr :20128
|
|
```
|
|
|
|
3. **ファイアウォールを確認:**
|
|
- macOS: システム設定 → ネットワーク → ファイアウォール
|
|
- Windows: Windows Defenderファイアウォール → アプリを許可
|
|
- Linux: `sudo ufw allow 20128`
|
|
|
|
4. **クラウドエンドポイントを使用:**
|
|
localhostが動作しない場合(例: Cursor IDE):
|
|
```
|
|
Endpoint: https://9router.com/v1
|
|
```
|
|
|
|
---
|
|
|
|
## ダッシュボードが開かない
|
|
|
|
**問題:** ダッシュボードがhttp://localhost:3000で読み込まれない。
|
|
|
|
**原因:**
|
|
- ポート3000がすでに使用中
|
|
- 9Routerがクラッシュした
|
|
- ブラウザキャッシュの問題
|
|
|
|
**解決策:**
|
|
|
|
1. **9Routerが実行中か確認:**
|
|
```bash
|
|
# プロセスを確認
|
|
ps aux | grep 9router
|
|
|
|
# ポート3000を確認
|
|
lsof -i :3000
|
|
```
|
|
|
|
2. **競合するプロセスを終了:**
|
|
```bash
|
|
# macOS/Linux
|
|
lsof -ti:3000 | xargs kill -9
|
|
|
|
# Windows
|
|
netstat -ano | findstr :3000
|
|
taskkill /PID <PID> /F
|
|
```
|
|
|
|
3. **9Routerを再起動:**
|
|
```bash
|
|
# 停止
|
|
pkill -f 9router
|
|
|
|
# 起動
|
|
9router
|
|
```
|
|
|
|
4. **ブラウザキャッシュをクリア:**
|
|
- Chrome: Ctrl+Shift+Delete → キャッシュをクリア
|
|
- シークレットモードを試す
|
|
|
|
5. **ファイアウォール設定を確認:**
|
|
ポート3000がブロックされていないことを確認。
|
|
|
|
---
|
|
|
|
## モデルが見つからない
|
|
|
|
**問題:** 「Model not found」または「Invalid model」エラー。
|
|
|
|
**原因:**
|
|
- プロバイダーが接続されていない
|
|
- モデルIDのタイポ
|
|
- プロバイダーが非アクティブ
|
|
|
|
**解決策:**
|
|
|
|
1. **プロバイダー接続を確認:**
|
|
```
|
|
Dashboard → Providers → ステータスを確認(緑 = アクティブ)
|
|
```
|
|
|
|
2. **モデルID形式を確認:**
|
|
```
|
|
正しい: cc/claude-opus-4-5-20251101
|
|
誤り: claude-opus-4-5-20251101
|
|
|
|
形式: [provider-prefix]/[model-name]
|
|
```
|
|
|
|
3. **利用可能なモデルを一覧表示:**
|
|
```bash
|
|
curl http://localhost:20128/v1/models \
|
|
-H "Authorization: Bearer your-api-key"
|
|
```
|
|
|
|
4. **プロバイダーを再接続:**
|
|
```
|
|
Dashboard → Providers → [Provider] → Reconnect
|
|
```
|
|
|
|
---
|
|
|
|
## 応答が遅い
|
|
|
|
**問題:** リクエストに時間がかかりすぎる、またはタイムアウト。
|
|
|
|
**原因:**
|
|
- プロバイダーのレイテンシ
|
|
- ネットワーク問題
|
|
- 大きなコンテキスト/応答
|
|
- プロバイダーのレート制限
|
|
|
|
**解決策:**
|
|
|
|
1. **プロバイダーステータスを確認:**
|
|
```
|
|
Dashboard → Providers → レイテンシ統計を表示
|
|
```
|
|
|
|
2. **高速モデルへ切替:**
|
|
```
|
|
高速: cc/claude-haiku-4-5 (HaikuはOpusより高速)
|
|
gc/gemini-3-flash-preview
|
|
qw/qwen3-coder-flash
|
|
```
|
|
|
|
3. **ストリーミングを使用:**
|
|
```json
|
|
{
|
|
"model": "cc/claude-opus-4-5",
|
|
"messages": [...],
|
|
"stream": true
|
|
}
|
|
```
|
|
|
|
4. **ネットワークを確認:**
|
|
```bash
|
|
# レイテンシをテスト
|
|
ping api.anthropic.com
|
|
ping api.openai.com
|
|
```
|
|
|
|
5. **コンテキストサイズを削減:**
|
|
- メッセージ履歴をトリミング
|
|
- 短いプロンプトを使用
|
|
- CLIツールでコンテキストの剪定を有効化
|
|
|
|
---
|
|
|
|
## APIキー無効
|
|
|
|
**問題:** 「Invalid API key」または「Authentication failed」エラー。
|
|
|
|
**原因:**
|
|
- 間違ったAPIキーをコピー
|
|
- APIキーが期限切れ
|
|
- APIキーが生成されていない
|
|
|
|
**解決策:**
|
|
|
|
1. **APIキーを再生成:**
|
|
```
|
|
Dashboard → Settings → API Keys → Generate New Key
|
|
→ 新しいキーをコピーして使用
|
|
```
|
|
|
|
2. **キー形式を確認:**
|
|
```
|
|
正しい: 9r_xxxxxxxxxxxxxxxxxxxxxxxx
|
|
誤り: 9r_プレフィックスがない
|
|
```
|
|
|
|
3. **CLI設定でキーを確認:**
|
|
```bash
|
|
# Cursor
|
|
Settings → Models → OpenAI API Key
|
|
|
|
# Cline
|
|
Settings → API Key
|
|
|
|
# 環境変数
|
|
export OPENAI_API_KEY="9r_your_key"
|
|
```
|
|
|
|
4. **APIキーをテスト:**
|
|
```bash
|
|
curl http://localhost:20128/v1/models \
|
|
-H "Authorization: Bearer 9r_your_key"
|
|
```
|
|
|
|
---
|
|
|
|
## さらにヘルプが必要?
|
|
|
|
- **GitHub Issues:** [github.com/decolua/9router/issues](https://github.com/decolua/9router/issues)
|
|
- **ドキュメント:** [9router.com/docs](https://9router.com/docs)
|
|
- **FAQ:** [faq.md](faq.md)
|