消息错误和疑难解答 - AWS SimSpace Weaver

终止支持通知:2026 年 5 月 20 日, AWS 将终止对的支持。 AWS SimSpace Weaver 2026 年 5 月 20 日之后,您将无法再访问 SimSpace Weaver 控制台或 SimSpace Weaver 资源。有关更多信息,请参阅AWS SimSpace Weaver 终止支持

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

消息错误和疑难解答

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

端点解析错误

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

域名检查

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

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

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

位置检查

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

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

消息发送错误

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

已超过每个应用程序、每次点击的消息发送限制

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

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

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

这种行为在中是一样的 SimSpace Weaver Local 然后在 AWS 云.

已超出消息有效负载大小限制

消息有效载荷大小的当前限制均为 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 云。

目的地与源相同

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

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

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

尽力发送消息

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