

终止支持通知：2026 年 5 月 20 日， AWS 将终止对的支持。 AWS SimSpace Weaver 2026 年 5 月 20 日之后，您将无法再访问 SimSpace Weaver 控制台或 SimSpace Weaver 资源。有关更多信息，请参阅[AWS SimSpace Weaver 终止支持](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 消息错误和疑难解答
<a name="working-with_messaging_troubleshooting"></a>

使用消息时，您可能会遇到以下错误 APIs。

## 端点解析错误
<a name="working-with_messaging_troubleshooting_endpoint-resolution"></a>

这些错误可能发生在应用程序发送消息之前。

### 域名检查
<a name="working-with_messaging_troubleshooting_dns-check"></a>

向无效端点发送消息会导致以下错误：

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

当您尝试向定制化 App 发送消息，但该定制化 App 尚未加入模拟时，就会发生这种情况。使用该 `DescribeSimulation` API 确保您的定制化应用程序已启动，然后再向其发送消息。这种行为在SimSpace Weaver Local和中是一样的 AWS 云。

### 位置检查
<a name="working-with_messaging_troubleshooting_position-check"></a>

尝试解析具有有效域名但位置无效的端点会导致以下错误。

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

我们建议使用 SimSpace Weaver 应用程序 SDK 中包含的`MessageUtils`库中的。`MessageEndpointResolver`

## 消息发送错误
<a name="working-with_messaging_troubleshooting_message-sending"></a>

应用程序发送消息时可能会出现以下错误。

### 已超过每个应用程序、每次点击的消息发送限制
<a name="working-with_messaging_troubleshooting_send-limit"></a>

目前，每个应用程序每次仿真跳动可以发送的消息数量限制为 128。同一报价的后续调用将失败，并出现以下错误：

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

SimSpace Weaver 尝试在下次勾选时发送未发送的消息。降低发送频率以解决此问题。合并小于 256 字节限制的消息负载，以减少出站消息的数量。

这种行为在中SimSpace Weaver Local和之中都是一样的 AWS 云。

### 已超出消息有效负载大小限制
<a name="working-with_messaging_troubleshooting_size-limit"></a>

当前消息有效载荷大小限制为 256 字节，两者SimSpace Weaver Local兼而有之 AWS 云。发送有效载荷大于 256 字节的消息会导致以下错误：

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

SimSpace Weaver 会检查每条消息，只拒绝超过限制的消息。例如，如果您的应用程序尝试发送 10 条消息，但有 1 条未通过检查，则只有这 1 条消息被拒绝。 SimSpace Weaver 发送其他 9 条消息。

这种行为在SimSpace Weaver Local和中是一样的 AWS 云。

### 目的地与源相同
<a name="working-with_messaging_troubleshooting_dst-src-same"></a>

应用程序无法向其拥有的分区发送消息。如果应用程序向其拥有的分区发送消息，则会出现以下错误。

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

这种行为在SimSpace Weaver Local和中是一样的 AWS 云。

### 尽力发送消息
<a name="working-with_messaging_troubleshooting_best-effort"></a>

SimSpace Weaver 不能保证消息的传送。该服务将尝试在随后的模拟滴答中完成消息的传送，但消息可能会丢失或延迟。