지원 종료 공지: 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>

메시지 페이로드 크기의 현재 제한은 및 모두에서 256바이트SimSpace Weaver Local입니다 AWS 클라우드. 페이로드가 256바이트보다 큰 메시지를 전송하면 다음 오류가 발생합니다.

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

SimSpace Weaver 는 각 메시지를 확인하고 한도를 초과하는 메시지만 거부합니다. 예를 들어 앱이 10개의 메시지를 보내려고 하는데 1개가 검사에 실패하면 해당 메시지 1개만 거부됩니다.는 다른 9개의 메시지를 SimSpace Weaver 보냅니다.

이 동작은 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 는 메시지 전송을 보장하지 않습니다. 서비스는 후속 시뮬레이션 틱에서 메시지 전송을 완료하려고 시도하지만 메시지가 손실되거나 지연될 수 있습니다.