ApsaraMQ for Kafka:O que fazer se ocorrer uma exceção quando um cliente se conecta ao ApsaraMQ for Kafka pela primeira vez?

Visão geral

Este tópico descreve como solucionar problemas de exceções que ocorrem quando um cliente se conecta ao ApsaraMQ for Kafka pela primeira vez.

Solução

Caso ocorra uma exceção durante a primeira conexão de um cliente ao ApsaraMQ for Kafka, verifique os itens a seguir para resolver o problema:

• Conectividade de rede: Na maioria dos casos, problemas de conectividade de rede têm uma das seguintes causas:

  • Se o cliente estiver implantado em uma instância do Elastic Compute Service (ECS), a exceção pode ocorrer porque a instância ECS não está na mesma virtual private cloud (VPC) da instância do ApsaraMQ for Kafka. Para obter informações sobre como acessar uma instância do ApsaraMQ for Kafka em uma VPC, consulte Purchase and deploy a VPC-connected instance.

  • Quando o cliente se conecta a uma instância do ApsaraMQ for Kafka vinculada a uma VPC, a exceção pode indicar que o acesso à instância foi feito pela Internet.

  • O endereço IP do cliente não foi adicionado à lista de permissões. Para saber como configure uma lista de permissões, consulte Configure whitelists.

• Versão do cliente: Versões desatualizadas podem gerar exceções. Recomendamos atualizar o cliente para uma versão compatível com a da instância do ApsaraMQ for Kafka. Para consultar exemplos de clientes, veja aliware-kafka-demos.

  Nota

  A versão do cliente deve corresponder à versão da instância do ApsaraMQ for Kafka. Por exemplo, se a sua instância do ApsaraMQ for Kafka for da versão 0.10.2.2, utilize um cliente também na versão 0.10.2.2. A versão da instância do ApsaraMQ for Kafka é a referência principal.

• Configuração: O acesso pode falhar se a configuração do endpoint padrão estiver incorreta ou se o usuário do Resource Access Management (RAM) não tiver as permissões necessárias. Para verificar as informações de configuração, consulte Overview.

Instruções

1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

5. Aplique todas as regras específicas do idioma rigorosamente

6. Siga as regras de stopwords com tolerância zero

7. Use o modo imperativo em etapas numeradas e listas procedimentais

8. Garanta consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

9. Varie os inícios de frase em listas e tabelas — nenhum iniciador deve se repetir mais de 3 vezes

10. Retorne APENAS o documento markdown em português do Brasil, sem explicações