Aviso de fim do suporte: em 20 de maio de 2026, AWS encerrará o suporte para AWS SimSpace Weaver. Depois de 20 de maio de 2026, você não poderá mais acessar o SimSpace Weaver console ou os SimSpace Weaver recursos. Para obter mais informações, consulte [AWS SimSpace Weaver Fim do suporte](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html). 

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Erros de mensagens e solução de problemas
<a name="working-with_messaging_troubleshooting"></a>

Você pode enfrentar os seguintes erros ao usar a mensagem APIs.

## Erros de resolução de endpoints
<a name="working-with_messaging_troubleshooting_endpoint-resolution"></a>

Esses erros podem ocorrer antes que um aplicativo envie uma mensagem.

### Verificação do nome de domínio
<a name="working-with_messaging_troubleshooting_dns-check"></a>

Enviar uma mensagem para um endpoint inválido resulta no seguinte erro:

```
ManifoldError::InvalidArgument {"No DomainId found for the given domain name" }
```

Isso pode acontecer quando você tenta enviar uma mensagem para um aplicativo personalizado e esse aplicativo personalizado ainda não entrou na simulação. Use a `DescribeSimulation` API para garantir que seu aplicativo personalizado tenha sido lançado antes de você enviar uma mensagem para ele. Esse comportamento é o mesmo em SimSpace Weaver Local e Nuvem AWS o.

### Verificação de posição
<a name="working-with_messaging_troubleshooting_position-check"></a>

Tentar resolver um endpoint com um nome de domínio válido, mas com uma posição inválida, resulta no seguinte erro.

```
ManifoldError::InvalidArgument {"Could not resolve endpoint from domain : DomainId { value: domain-id } and position: Vector2F32 { x: x-position, y: y-position}" }
```

Sugerimos usar o `MessageEndpointResolver` na `MessageUtils` biblioteca contida no SDK do SimSpace Weaver aplicativo.

## Erros de envio de mensagens
<a name="working-with_messaging_troubleshooting_message-sending"></a>

Os erros a seguir podem ocorrer quando um aplicativo envia uma mensagem.

### Limite de envio de mensagens por aplicativo, por tick, excedido
<a name="working-with_messaging_troubleshooting_send-limit"></a>

O limite atual para o número de mensagens que podem ser enviadas por aplicativo por clique de simulação é 128. As chamadas subsequentes com o mesmo tick falharão com o seguinte erro: 

```
ManifoldError::CapacityExceeded {"At Max Outgoing Message capacity: {}", 128}
```

SimSpace Weaver tenta enviar mensagens não enviadas na próxima marca. Diminua a frequência de envio para resolver esse problema. Combine cargas de mensagens menores que o limite de 256 bytes para reduzir o número de mensagens de saída.

Esse comportamento é o mesmo em SimSpace Weaver Local e no Nuvem AWS. 

### Limite de tamanho da carga útil da mensagem excedido
<a name="working-with_messaging_troubleshooting_size-limit"></a>

O limite atual para o tamanho da carga útil da mensagem é 256 bytes em ambos SimSpace Weaver Local e no Nuvem AWS. Enviar uma mensagem com uma carga útil maior que 256 bytes resulta no seguinte erro:

```
ManifoldError::CapacityExceeded {"Message data too large! Max size: {}", 256}
```

SimSpace Weaver verifica cada mensagem e rejeita somente aquelas que excedem o limite. Por exemplo, se seu aplicativo tentar enviar 10 mensagens e 1 falhar na verificação, somente essa mensagem será rejeitada. SimSpace Weaver envia as outras 9 mensagens.

Esse comportamento é o mesmo em SimSpace Weaver Local e Nuvem AWS o.

### O destino é o mesmo que a origem
<a name="working-with_messaging_troubleshooting_dst-src-same"></a>

Os aplicativos não podem enviar mensagens para as partições de sua propriedade. Você receberá o erro a seguir se um aplicativo enviar uma mensagem para uma partição de sua propriedade.

```
ManifoldError::InvalidArgument { "Destination is the same as source" }
```

Esse comportamento é o mesmo em SimSpace Weaver Local e Nuvem AWS o.

### Mensagens de melhor esforço
<a name="working-with_messaging_troubleshooting_best-effort"></a>

SimSpace Weaver não garante a entrega da mensagem. O serviço tentará concluir a entrega das mensagens na simulação subsequente, mas as mensagens podem ser perdidas ou atrasadas.