

終止支援通知： 將於 2026 AWS 年 5 月 20 日結束對 的支援 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" }
```

當您嘗試傳送訊息至自訂應用程式，且該自訂應用程式尚未加入模擬時，可能會發生這種情況。使用 `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 `MessageEndpointResolver`中包含的`MessageUtils`程式庫中使用 。

## 訊息傳送錯誤
<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>

在 SimSpace Weaver Local和 中，訊息承載大小的目前限制為 256 個位元組 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 不保證訊息交付。服務會嘗試在後續模擬刻度上完成訊息傳遞，但訊息可能會遺失或延遲。