Todos os produtos
Search
Central de documentação

Mobile Platform as a Service:Referência de códigos de resultado do gateway

Última atualização: Jun 28, 2026

Este tópico descreve os códigos de resultado do Mobile Gateway Service para ajudar na solução de problemas.

Códigos de resultado do lado do gateway

  • O código de resultado 1000 indica uma chamada de API bem-sucedida. Todos os outros códigos indicam erros.

  • Os códigos de resultado de 1001 a 5999 e na faixa 7XXX indicam erros de gateway.

    • Códigos na faixa 7XXX indicam erros de verificação de assinatura ou descriptografia do Security Guard. Para obter mais informações, consulte Referência de códigos de resultado do Security Guard.

    • Além do código de resultado, verifique os campos Memo e tips no cabeçalho da resposta para obter mais informações sobre o erro.

    • Usuários do Apsara Stack também podem visualizar informações detalhadas de erro no arquivo ~/logs/gateway/gateway-error.log no servidor de gateway.

  • Se ocorrer uma exceção, solucione-a usando o guia de solução de problemas de exceções do gateway. Para obter mais informações, consulte Solução de problemas de exceções do gateway.

Código de resultado

Descrição

Explicação

1000

Sucesso

O gateway processou a chamada da API com êxito.

1001

Acesso negado

O formato mock está incorreto, o campo resultStatus está ausente, a validação do Web Application Firewall (WAF) falhou ou o usuário não tem permissão para acessar a API de autenticação.

1002

Limite de chamadas de API excedido

Essa exceção ocorre quando o limite de taxa de solicitações é acionado após a ativação do limitador de fluxo.

1005

Não autorizado

Essa exceção ocorre quando a autorização da API falha após a ativação da autorização de API.

2000

Tempo limite de logon

Essa exceção é acionada em um estado sem logon quando o recurso de autorização está ativado.

3000

A interface RPC não existe ou está fechada

No ambiente correspondente ao workspaceId atual, o serviço de API para o operationType especificado não está configurado para o aplicativo móvel correspondente ao appId, ou o serviço de API não está no estado Active.

3001

Dados da solicitação vazios

O campo requestData na solicitação do cliente está vazio. Verifique se o RPC do cliente funciona corretamente. Para clientes iOS, confirme que você inicializou o serviço de gateway.

3002

Formato de dados incorreto

O formato da solicitação RPC está incorreto. Usuários do Apsara Stack podem visualizar detalhes no arquivo gateway-error.log do lado do servidor.

3003

Falha na descriptografia de dados

A descriptografia dos dados falhou.

4001

Tempo limite de solicitação de serviço

O Mobile Gateway Service (MGS) atingiu o tempo limite ao chamar o serviço do sistema de negócios devido à alta carga no back-end. Verifique o status operacional do sistema de back-end. Se a configuração de tempo limite não for adequada, ajuste-a conforme necessário. Observação: O tempo limite padrão é de 3 s.

4002

Exceção na chamada remota ao sistema de negócios

Ocorreu uma exceção quando o MGS chamou o serviço do sistema de negócios. Usuários do Apsara Stack podem visualizar detalhes no arquivo gateway-error.log do lado do servidor.

4003

Exceção de HOST do grupo de APIs

Ocorreu uma UnknownHostException quando o MGS chamou o serviço HTTP do sistema de negócios. Verifique se o nome de domínio configurado para o grupo de APIs existe.

5000

Exceção desconhecida

Outros erros críticos. Usuários do Apsara Stack podem visualizar detalhes no arquivo gateway-error.log do lado do servidor.

7000

Chave pública não definida

A chave correspondente ao appId não existe no Security Guard para o aplicativo móvel, ou o gateway não consegue obter a chave de assinatura para o appId.

7001

Parâmetros insuficientes para verificação de assinatura

A verificação de assinatura no lado do servidor pelo gateway falhou.

7002

Falha na verificação de assinatura

A verificação de assinatura no lado do servidor pelo gateway falhou.

7003

Verificação de assinatura - falha de atualidade

O carimbo de data/hora ts nos parâmetros da solicitação da API expirou com base no período de validade do sistema. Verifique se a hora do cliente está sincronizada com a hora do sistema.

7007

Verificação de assinatura - parâmetro ts ausente

O parâmetro ts para verificação de assinatura está ausente na solicitação da API.

7014

Verificação de assinatura - parâmetro sign ausente

O parâmetro sign para verificação de assinatura está ausente na solicitação da API. Geralmente, isso ocorre porque o cliente não conseguiu assinar os dados. Verifique se a imagem do Security Guard do cliente está correta.

8002

Solicitação de preflight entre domínios (CORS preflight)

Solicitação de preflight entre domínios.

Códigos de resultado do lado do serviço

Visualize as informações de erro dos seguintes códigos de resultado no servidor do sistema de negócios.

Para determinar os detalhes específicos da exceção, visualize o log ~/logs/mobileservice/monitor.log em cada sistema de negócios.

Código de resultado

Protocolo aplicável

Descrição

Explicação

6000

MPC, DUBBO

RPC - Serviço de destino não encontrado

O serviço publicado não foi localizado. O servidor está inacessível ou o serviço foi migrado.

6001

MPC, DUBBO

RPC - Método de destino não encontrado

O método dentro do serviço publicado não foi localizado.

6002

MPC, DUBBO

RPC - Número incorreto de parâmetros

O número de parâmetros de entrada não corresponde ao número de parâmetros declarados.

6003

MPC, DUBBO

RPC - Método de destino não acessível

Não é possível invocar o método de destino.

6004

HTTP, MPC, DUBBO

RPC - Exceção de análise JSON

HTTP: Ocorreu uma exceção ao converter parâmetros RPC em parâmetros de solicitação HTTP de back-end. MPC/DUBBO: Falha ao desserializar dados formatados em JSON do RPC em objetos de parâmetros de negócios.

6005

MPC, DUBBO

RPC - Parâmetros inválidos ao chamar o método de destino

Os parâmetros são inválidos para chamadas baseadas em reflexão.

6007

MPC, DUBBO

RPC - Serviço de autenticação de logon indisponível

A interface de autenticação de logon no pacote Service Provider Interface (SPI) não está implementada ou está configurada incorretamente.

6666

HTTP, MPC, DUBBO

RPC - Exceção lançada pelo negócio

HTTP: O sistema de back-end retornou um código de status HTTP diferente de 200. MPC/DUBBO: Uma exceção foi lançada pelo negócio. O RPC não consegue processá-la e a trata como uma exceção de negócios.

Códigos de resultado do cliente Android

Código de resultado

Descrição

Texto do prompt

0

Erro desconhecido

Erro desconhecido. Tente novamente mais tarde.

1

O cliente não encontra o objeto de comunicação porque nenhum transporte foi definido.

Erro de rede. Tente novamente mais tarde.

2

O cliente não tem conectividade de rede, como quando o usuário desliga a rede ou desativa as permissões de rede para o aplicativo.

Não é possível conectar-se à rede.

3

Erros relacionados a SSL, incluindo erros de handshake SSL e erros de certificado SSL.

O certificado do cliente está incorreto. Verifique se a configuração de hora do telefone está precisa.

4

A conexão de rede do cliente atingiu o tempo limite. Este erro ocorre quando a conexão TCP excede o período de tempo limite de 10 s.

Conexão de rede instável.

5

Uma operação de leitura/gravação de dados atingiu o tempo limite. Este erro geralmente ocorre quando a velocidade da rede do cliente é muito lenta (cenário socketTimeout).

Conexão de rede instável.

6

O cliente enviou uma solicitação ao servidor, mas não recebeu resposta (NoHttpResponseException).

Erro de rede. Tente novamente mais tarde.

7

Ocorreu um erro de E/S de rede do cliente (IOException).

Erro de rede. Tente novamente mais tarde.

8

Ocorreu um erro de agendamento de solicitação de rede do cliente porque o thread de execução foi interrompido.

Erro de rede. Tente novamente mais tarde.

9

Erro de processamento do cliente, incluindo erros de serialização, erros de processamento de anotações e erros de execução de thread.

Erro de rede. Tente novamente mais tarde.

10

Ocorreu um erro de desserialização de dados do cliente porque o formato dos dados do servidor está incorreto.

Erro de rede. Tente novamente mais tarde.

13

Erro de interrupção de solicitação, como quando uma solicitação de rede é interrompida porque seu thread foi interrompido.

Erro de rede. Tente novamente mais tarde.

15

Ocorreu um erro de autorização de rede do cliente (HttpHostConnectException: "Connection to xxx refused"). Este erro indica que não há conectividade de rede ou que o servidor rejeitou a conexão.

Não é possível conectar-se à rede.

16

Erro de resolução DNS

Não é possível conectar-se à rede. Tente novamente mais tarde.

18

Limitação de rede. Este erro é acionado quando o tráfego de solicitações do cliente excede o limiar de limitação do lado do cliente.

O acesso à rede está limitado. Tente novamente mais tarde.

code ≥ 400 e code < 500

Um código de status HTTP na faixa 4xx.

Não é possível conectar-se à rede.

400 > code ≥ 100 e 500 < code < 600

Um código de status HTTP sem êxito foi retornado.

Não é possível conectar-se à rede. Tente novamente mais tarde.

Códigos de erro de solicitação RPC do iOS

Valor

Código de status

Significado

0

kDTRpcNetworkError

Não é possível conectar-se à rede.

Importante

Todas as falhas de rede são classificadas sob este código. O erro específico é transmitido via userinfo. A chave para obter o erro correspondente do dicionário userinfo é kDTRpcErrorCauseError.

1

kDTRpcEmptyResponse

Os dados retornados pelo servidor estão vazios.

2

kDTRpcInvalidJSONString

A string JSON retornada pelo servidor não está no formato correto e não pode ser convertida em um objeto JSON.

3

kDTRpcDecodeObjectError

Erro ao desserializar o objeto JSON.

4

kDTRpcNetworkCancelled

A solicitação de rede foi cancelada.

5

kDTRpcEncodeObjectError

Erro ao serializar o objeto JSON.

6

kDTRpcProtocolBuffersDecodeError

Erro ao desserializar o objeto Protocol Buffers (PB).

9

KDTRpcSizeControlError

Uma exceção é lançada diretamente se o payload do RPC for muito grande. Este erro é delegado ao chamador: [DTRpcInterface rpcSizeControl:size:isReq:NO].

24

KDTRpcAbandonError

Após o retorno de um RPC de logon durante uma troca de conta, o RPC é descartado e uma exceção é lançada diretamente.

3003

/

Erro de descriptografia.