概要
このトピックでは、クライアントが初めて ApsaraMQ for Kafka に接続するときに発生する例外のトラブルシューティング方法について説明します。
解決策
クライアントが初めて ApsaraMQ for Kafka に接続するときに例外が発生した場合は、次の項目を確認して例外のトラブルシューティングを行うことができます。
ネットワーク接続：ほとんどの場合、ネットワーク接続の問題は次のいずれかの理由で発生します。
クライアントが Elastic Compute Service (ECS) インスタンスにデプロイされている場合、ECS インスタンスが ApsaraMQ for Kafka インスタンスと同じ仮想プライベートクラウド (VPC) 内に存在しないために例外が発生することがあります。VPC 内の ApsaraMQ for Kafka インスタンスへのアクセス方法については、「VPC タイプのインスタンスを購入してデプロイする」をご参照ください。
クライアントが VPC タイプの ApsaraMQ for Kafka インスタンスに接続する場合、インターネット経由で ApsaraMQ for Kafka インスタンスにアクセスしたために例外が発生することがあります。
クライアントの IP アドレスがホワイトリストに追加されていません。ホワイトリストの構成方法については、「ホワイトリストを構成する」をご参照ください。
クライアントバージョン：クライアントバージョンが古い場合、例外が発生することがあります。クライアントを ApsaraMQ for Kafka インスタンスのバージョンと一致するバージョンにアップグレードすることをお勧めします。クライアントデモについては、aliware-kafka-demos をご参照ください。
説明クライアントのバージョンは、ApsaraMQ for Kafka インスタンスのバージョンと一致している必要があります。たとえば、ApsaraMQ for Kafka インスタンスのバージョンが 0.10.2.2 の場合は、バージョン 0.10.2.2 のクライアントを使用することをお勧めします。 ApsaraMQ for Kafka インスタンスのバージョンが優先されます。
構成：デフォルトエンドポイントの構成が無効であるか、Resource Access Management (RAM) ユーザーに必要な権限が付与されていない場合、アクセスが失敗することがあります。構成情報を確認するには、「概要」をご参照ください。