Falhas na primeira conexão entre um cliente Kafka e uma instância do ApsaraMQ for Kafka geralmente se enquadram em três categorias: conectividade de rede, incompatibilidade de versão do cliente ou configuração incorreta. Siga as verificações abaixo em ordem; a maioria dos problemas é resolvida nas duas primeiras seções.
Verifique a conectividade de rede
Problemas de rede são a causa mais comum de falhas na primeira conexão. Identifique qual cenário de rede se aplica à sua implantação e verifique a conectividade.
Cliente e instância na mesma VPC
Se o cliente for executado em uma instância do Elastic Compute Service (ECS) na mesma vpc da instância do ApsaraMQ for Kafka, verifique se ele alcança o endpoint do broker listado na página de detalhes da instância no console do ApsaraMQ for Kafka.
Cliente e instância em VPCs diferentes
Uma instância do ApsaraMQ for Kafka conectada via VPC só é acessível de dentro da mesma VPC. Se a instância ECS estiver em uma VPC diferente, a conexão falhará.
Solução: Implante o cliente em uma instância ECS que resida na mesma VPC da instância do ApsaraMQ for Kafka. Para instruções de configuração, consulte Comprar e implantar uma instância conectada à VPC.
Conexão do cliente pela Internet a uma instância conectada à VPC
Instâncias conectadas à VPC não expõem endpoint público. Tentativas de acesso pela Internet falham porque essas instâncias aceitam tráfego apenas de dentro da VPC.
Solução: Implante o cliente dentro da mesma VPC ou use uma instância do ApsaraMQ for Kafka habilitada para Internet, que fornece um endpoint público.
Endereço IP do cliente ausente na lista de permissões
Mesmo com o cliente na VPC correta, o ApsaraMQ for Kafka bloqueia conexões de endereços ip que não constam na lista de permissões da instância.
Solução: Adicione o endereço ip do cliente à lista de permissões. Para obter instruções, consulte Configurar listas de permissões.
Verifique a versão do cliente
Incompatibilidades de versão entre a biblioteca do cliente Kafka e o broker do ApsaraMQ for Kafka podem causar erros de conexão ou comportamento inesperado.
Alinhe a versão da biblioteca do cliente à versão do broker exibida na página de detalhes da instância no console do ApsaraMQ for Kafka. A versão do broker tem prioridade; sempre adapte o cliente a ela, nunca o contrário.
Por exemplo, se a instância executar a versão do broker 0.10.2.2, use uma biblioteca de cliente Kafka da mesma versão.
Para exemplos funcionais de código de cliente em várias linguagens, consulte aliware-kafka-demos.
Verifique a configuração de endpoint e permissões
Se a conectividade de rede e a versão do cliente estiverem corretas, o problema provavelmente estará na configuração do cliente.
Endpoint inválido ou incorreto
Certifique-se de que o endereço do endpoint na configuração do cliente corresponda ao default endpoint exibido na página de detalhes da instância. Erros comuns incluem:
Cópia do endpoint referente ao método de acesso errado (VPC vs. Internet).
Cópia do endpoint de outra instância.
Se a instância tiver endpoints públicos e de VPC, cada método de acesso terá uma string de endpoint distinta. Usar o endpoint incorreto causará falha na conexão.
Permissões RAM ausentes
Se a conta Alibaba Cloud usada pelo cliente for um usuário do Resource Access Management (RAM), verifique se ele possui as permissões necessárias para acessar os recursos do ApsaraMQ for Kafka. O broker rejeita tentativas de conexão de contas com permissões insuficientes.
Para a lista completa de verificação de configuração, incluindo definição de endpoint e permissões RAM, consulte Visão geral de introdução.
Entre em contato com o suporte
Se o problema persistir após as três verificações acima, reúna as informações a seguir e entre em contato com o suporte da Alibaba Cloud:
Mensagem de exceção completa e stack trace do cliente
ID da instância do ApsaraMQ for Kafka e versão do broker
Ambiente de rede (ID da VPC, ID da instância ECS, região)
Linguagem e versão da biblioteca do cliente