Esta página mostra como resolver problemas com a desembrulhagem do conteúdo.
Erros de código de estado HTTP
Quando usa a anulação da união de dados de conteúdo, podem ocorrer erros comuns de código de estado HTTP.
Pode monitorizar os erros com a métrica push_request_count.
400 Pedido errado
Ocorre o seguinte erro quando o Pub/Sub não consegue processar o pedido devido a uma configuração incorreta ou a dados em falta.
400 Bad Request
Este erro ocorre por vários motivos. Seguem-se algumas das causas mais comuns do erro:
- A carga útil (dados da mensagem) não corresponde ao formato de pedido esperado especificado pelo ponto final HTTP.
- Faltam os cabeçalhos necessários para processar o pedido.
- Foi configurado um ponto final de HTTP incorreto para a subscrição.
Para resolver este problema, experimente as seguintes soluções:
- Verifique o formato da sua carga útil (dados da mensagem). Certifique-se de que corresponde ao formato de pedido esperado especificado pelo ponto final HTTP.
- Verifique se o pedido contém os cabeçalhos necessários. Se os cabeçalhos estiverem em falta,
pode ter de os adicionar nos atributos da mensagem. Um exemplo pode incluir
Content-Type, mas também podem ser necessários outros. - Confirme que o ponto final HTTP configurado para a sua subscrição é válido.
- Ative a fila de mensagens rejeitadas (DLQ) na sua subscrição push. Isto redireciona mensagens individuais que não podem ser entregues. É útil ativar a DLQ se vir um pequeno número de erros 400 que quer inspecionar.
401 não autorizado / 403 proibido
O seguinte erro ocorre quando o Pub/Sub não consegue processar o pedido devido a credenciais incorretas ou inválidas.
401 unauthorized / 403 forbidden
Este erro ocorre porque a subscrição push não está autenticada.
Para resolver este problema, experimente as seguintes soluções:
Ative a autenticação por envio. A utilização da autenticação push é importante se estiver a fazer a integração com o Cloud Run ou o App Engine.
Se a autenticação push não funcionar com a sua solução, pode ter de adicionar a sua própria chave de autorização ou chave da API nos atributos da mensagem de publicação.
415 Tipo de ficheiro de multimédia não suportado
O seguinte erro ocorre quando o Pub/Sub não consegue processar o pedido porque o formato da carga útil está num formato não suportado.
415 Unsupported Media Type
Este erro ocorre por vários motivos. Seguem-se algumas das causas mais comuns do erro:
- O ponto final não tem o cabeçalho de tipo de suporte obrigatório.
Para resolver este problema, experimente a seguinte solução:
- É provável que o seu ponto final exija um cabeçalho
Content-Type. Por predefinição, a anulação da união do payload não define um cabeçalho de tipo de suporte. Pode definir um cabeçalhoContent-Typeanexando-o como um atributo de mensagem de publicação.
431 request header fields too large / 413 content too large
O seguinte erro ocorre quando o Pub/Sub não consegue processar o pedido porque o conteúdo enviado no pedido é demasiado grande.
431 request header fields too Large / 413 content too large
Este erro ocorre se os atributos numa mensagem do Pub/Sub excederem o tamanho do limite do cabeçalho de um servidor.
Para resolver estes problemas, experimente as seguintes soluções:
- Desative a opção Escrever metadados.
- Ative a fila de mensagens rejeitadas (DLQ) na sua subscrição push. Isto redireciona mensagens individuais que não podem ser entregues. Depois, a subscrição continua a funcionar, mas as mensagens com erros são redirecionadas para um tópico separado para análise mais detalhada.
Verifique se a anulação da união da carga útil está ativada
Na Google Cloud consola, aceda à página Subscrições.
Clique no nome do seu serviço.
É apresentada a página de detalhes do serviço.
Na tabela de configuração, encontre os seguintes valores: Desembrulhar dados de mensagens e Escrever metadados de mensagens.
O estado da união de payloads (ativado ou desativado) é apresentado na linha da tabela correspondente.
O que se segue?
- Se continuar a ter problemas com a anulação da união da carga útil, consulte a secção Obter apoio técnico.