問題の概要
Amazon Q Developer CLI で q login を実行した際に、以下のエラーが発生することがあります：
✔ Select login method · Use for Free with Builder ID
error: dispatch failure
このエラーにより、正常にログインできない状態が続く場合があります。
症状
q loginコマンドを実行すると「dispatch failure」エラーが表示される- 何度ログインを試行してもエラーが継続する
qコマンド実行時に「You are not logged in」メッセージが表示される
解決方法
ステップ1: 現在のログイン状態を確認
q login
Already logged inもし「Already logged in」メッセージが表示される場合は、次のステップに進んでください。
ステップ2: 完全にログアウトする
q logout
ステップ3: 再度ログインを実行
q login
ステップ4: ブラウザ認証を完了する
Use for Free with Builder IDを選択- 表示されたコード（例：XXXX-XXXX）をメモ
- 指定されたURL（
https://view.awsapps.com/start/#/device?user_code=XXXX-XXXX）をブラウザで開く - コードを入力して認証を完了
実際の解決例
$ q logout
You are now logged out
Run q login to log back in to Amazon Q
$ q login
✔ Select login method · Use for Free with Builder ID
Confirm the following code in the browser
Code: XXXX-XXXX
Open this URL: https://view.awsapps.com/start/#/device?user_code=XXXX-XXXX
Device authorized
Logged in successfully
追加のトラブルシューティング
アップデート確認
問題が解決しない場合は、Amazon Q のバージョンを確認してください：
q update
新しいバージョンが利用可能な場合は、アップデートを実行することで問題が解決する場合があります。
環境要因
WSL（Windows Subsystem for Linux）環境でこの問題が発生することが多いようです。同様の環境で作業している場合は、上記の手順が特に有効です。
まとめ
「dispatch failure」エラーは、ログイン状態の不整合が原因で発生することが多いです。完全にログアウトしてから再ログインすることで、ほとんどの場合問題が解決します。
ブラウザでの認証手順を正確に実行することが成功の鍵となります。
コメント