

终止支持通知：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)。

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

# 中的疑难解答 SimSpace Weaver
<a name="troubleshooting"></a>

**Topics**
+ [AssumeRoleAccessDenied](troubleshooting_assume-role-denied.md)
+ [InvalidBucketName](troubleshooting_bucket-name-too-long.md)
+ [ServiceQuotaExceededException](troubleshooting_quota-exceeded.md)
+ [TooManyBuckets](troubleshooting_too-many-buckets.md)
+ [启动模拟时权限被拒绝](troubleshooting_permission-denied-during-sim-launch.md)
+ [使用 Docker 时与时间相关的问题](troubleshooting_docker-time-problems.md)
+ [PathfindingSample 控制台客户端无法连接](troubleshooting_console-client-connect-error.md)
+ [他们认 AWS CLI 不出来 `simspaceweaver`](troubleshooting_old-cli.md)

# AssumeRoleAccessDenied
<a name="troubleshooting_assume-role-denied"></a>

如果您的模拟无法启动，可能会收到以下错误：

```
Unable to assume role arn:aws:iam::111122223333:role/weaver-project-name-app-role; verify the role exists and has trust policy on SimSpace Weaver
```

如果您的模拟的 AWS Identity and Access Management (IAM) 角色存在以下任一情况，则可能会收到此错误：
+ Amazon 资源名称 (ARN) 是指不存在的 IAM 角色。
+ IAM 角色的信任策略，该策略不允许使用此名称的新模拟担任此角色。

检查以确保该角色存在。如果该角色存在，请查看角色的信任策略。以下示例信任策略中的 `aws:SourceArn` 仅允许名称以 `MySimulation` 开头的模拟（账户 111122223333 中）代入该角色。

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "simspaceweaver.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MySimulation*"
                }
            }
        }
    ]
}
```

------

要允许名称以 `MyOtherSimulation` 开头的另一个模拟担任该角色，必须修改信任策略，如以下编辑后的示例所示：

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "simspaceweaver.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "ArnLike": {
                    "aws:SourceArn": [
                        "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MySimulation*",
                        "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MyOtherSimulation*"
                        ]
                }
            }
        }
    ]
}
```

------

# InvalidBucketName
<a name="troubleshooting_bucket-name-too-long"></a>

创建项目时，您可能会收到以下错误：

```
An error occurred (InvalidBucketName) when calling the CreateBucket operation: The specified bucket is not valid.
```

您之所以收到此错误，是因为 SimSpace Weaver 传递给亚马逊简单存储服务 (Amazon S3) 的名称违反了存储桶命名规则（有关更多信息，[请参阅*亚马逊简单存储服务用户指南中的存储*桶命名](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html)规则）。

 SimSpace Weaver 应用程序 SDK 中的`create-project`脚本使用您为脚本提供的项目名称创建存储桶名称。存储桶名称采用以下格式。
+ 版本 1.13.x 或更高版本
  + `weaver-lowercase-project-name-account-number-region`
+ 版本 1.12.x
  + `weaver-lowercase-project-name-account-number-app-zips-region`
  + `weaver-lowercase-project-name-account-number-schemas-region`

例如，指定以下项目属性：
+ 项目名称：`MyProject`
+ AWS 账户 数字:`111122223333`
+ AWS 区域: `us-west-2`

项目可能包含以下存储桶：
+ 版本 1.13.x 或更高版本
  + `weaver-myproject-111122223333-us-west-2`
+ 版本 1.12.x
  + `weaver-myproject-111122223333-app-zips-us-west-2`
  + `weaver-myproject-111122223333-schemas-us-west-2`

您的项目名称不得违反 Amazon S3 命名规则。您还必须使用足够短的项目名称，以便 `create-project` 脚本创建的存储桶名称不会超过 Amazon S3 存储桶的名称长度限制。

# ServiceQuotaExceededException
<a name="troubleshooting_quota-exceeded"></a>

当您启动模拟时，可能会收到以下错误：

```
An error occurred (ServiceQuotaExceededException) when calling the StartSimulation operation: Failed to start simulation due to: simulation quota has already been reached.
```

如果您尝试启动新的模拟，但您的账户中目标状态为“已启动”的当前模拟数量已达到上限，则会收到此错误。这些模拟包括正在运行的模拟、失败的模拟以及由于达到最长运行时间而被停止的模拟。您可以删除已停止或失败的模拟，以便能够启动新的模拟。如果所有模拟都在运行，则可以停止和删除一个正在运行的模拟。您也可以请求提高服务限额（如果尚未达到请求限制）。

# TooManyBuckets
<a name="troubleshooting_too-many-buckets"></a>

创建项目时，您可能会收到以下错误：

```
An error occurred (TooManyBuckets) when calling the CreateBucket operation: You have attempted to create more buckets than allowed.
```

亚马逊简单存储服务 (Amazon S3) Simple Service 对 AWS 您的账户中可以拥有的存储桶数量有限制（有关更多信息，[请参阅*亚马逊简单存储服务用户指南中的存储*桶限制和限制](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html)）。

要继续，您必须执行以下操作之一：
+ 删除 2 个或更多不需要的现有 Amazon S3 存储桶。
+ 请求提高 Amazon S3 限制（有关更多信息，请参阅《Amazon Simple Storage Service 用户指南》**中的[存储桶限制](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html)。）
+ 使用其他 AWS 账户。

**注意**  
中的 `DeleteSimulation` API SimSpace Weaver 不会删除与您的模拟关联的 Amazon S3 资源。如果不再需要，我们建议您删除与您的模拟相关联的所有资源。

# 启动模拟时权限被拒绝
<a name="troubleshooting_permission-denied-during-sim-launch"></a>

当您启动模拟时，可能会收到一条错误消息，指出权限被拒绝或访问您的应用程序构件时出错。如果您为模拟指定 Amazon S3 存储桶，但该存储桶 SimSpace Weaver 不是为您创建的（通过控制台或 SimSpace Weaver 应用程序 SDK 脚本），则可能会出现此问题。

最可能的根本原因如下：
+ **该服务无权访问您在模拟架构中指定的一个或多个 Amazon S3 存储桶** – 请检查您的应用程序角色权限策略、Amazon S3 存储桶策略和 Amazon S3 存储桶权限，确保 `simspaceweaver.amazonaws.com` 具有访问您的存储桶的正确权限。有关应用程序角色权限策略的更多信息，请参阅[SimSpace Weaver 为您创建的权限](security_iam_service-created-permissions.md)。
+ **您的 Amazon S3 存储桶可能与您的模拟 AWS 区域 不同** — 您的模拟项目的 Amazon S3 存储桶必须与您的模拟 AWS 区域 相同。请查看您的 Amazon S3 控制台以查看 AWS 区域 您的存储桶在哪里。如果您的 Amazon S3 存储桶位于其他存储桶中 AWS 区域，请选择与您的模拟 AWS 区域 相同的存储桶。

# 使用 Docker 时与时间相关的问题
<a name="troubleshooting_docker-time-problems"></a>

如果您正在使用，Docker并且在运行来自 SimSpace Weaver 应用程序 SDK 的脚本时收到与时间相关的错误，则原因可能是您的Docker虚拟机时钟不正确。如果您的计算机此前正在运行 Docker，之后从睡眠或休眠状态恢复，则可能会发生这种情况。

**可尝试的解决方案**
+ 重新启动 Docker。
+ 在 **Windows PowerShell** 中禁用并重新启用时间同步：

  ```
  Get-VMIntegrationService -VMName DockerDesktopVM -Name "Time Synchronization" | Disable-VMIntegrationService
  Get-VMIntegrationService -VMName DockerDesktopVM -Name "Time Synchronization" | Enable-VMIntegrationService
  ```

# PathfindingSample 控制台客户端无法连接
<a name="troubleshooting_console-client-connect-error"></a>

当您连接到中教程中所述的`PathfindingSample`模拟时，您可能会从控制台客户端收到以下错误[入门 SimSpace Weaver](getting-started.md)。之所以出现此错误，是因为客户端无法通过您提供的 IP 地址和端口号组合打开与 `ViewApp` 的网络连接。

```
Fatal error in function nng_dial. Error code: 268435577. Error message: no link
```

**要在中进行模拟 AWS 云**
+ **您的网络连接能否正常工作？** 确认您可以连接到其他应该正常运行的 IP 地址或网站。确保您的网络浏览器不是从其缓存中加载的网站。
+ **您的模拟在运行吗？** 您可以使用 **ListSimulations**API 来获取仿真状态。有关更多信息，请参阅 [获取定制化应用程序的 IP 地址和端口号获取 IP 地址和端口号](working-with_get-ip.md)。您也可以使用 [SimSpace Weaver 控制台](https://console.aws.amazon.com/simspaceweaver)来查看模拟的状态。
+ **您的应用程序在运行吗？** 您可以使用 **DescribeApp**API 来获取应用程序的状态。有关更多信息，请参阅 [获取定制化应用程序的 IP 地址和端口号获取 IP 地址和端口号](working-with_get-ip.md)。您也可以使用 [SimSpace Weaver 控制台](https://console.aws.amazon.com/simspaceweaver)来查看模拟的状态。
+ **您的应用程序在运行吗？** 您可以使用 **DescribeApp**API 来获取应用程序的状态。有关更多信息，请参阅 [获取定制化应用程序的 IP 地址和端口号获取 IP 地址和端口号](working-with_get-ip.md)。您也可以使用 [SimSpace Weaver 控制台](https://console.aws.amazon.com/simspaceweaver)来查看模拟的状态。
+ **您使用的 IP 地址和端口号是否正确？** 通过互联网连接时，您必须使用 `ViewApp` 的 IP 地址和 `Actual` 端口号。您可以在 **DescribeApp**API 输出`EndpointInfo`区块中找到 IP `Address` 和`Actual`端口号。您也可以使用 [SimSpace Weaver 控制台](https://console.aws.amazon.com/simspaceweaver)在 `MyViewDomain` 详细信息页面中查找 `ViewApp` 的 IP 地址 (**URI**) 和端口号（**入口端口**）。
+ **您的网络连接是否有防火墙保护？** 防火墙可能会阻止您与 IP 地址或端口号（或两者）的连接。请检查您的防火墙设置或咨询您的防火墙管理员。

**对于本地模拟**
+ **您可以连接到环回地址 (127.0.0.1) 吗？** 如果您在 Windows 中使用 `ping` 命令行工具，则可以打开命令提示符窗口并尝试 Ping 127.0.0.1。按 Ctrl-C 以结束 Ping 操作。

  ```
  ping 127.0.0.1
  ```  
**Example Ping 输出**  

  ```
  C:\>ping 127.0.0.1
  
  Pinging 127.0.0.1 with 32 bytes of data:
  Reply from 127.0.0.1: bytes=32 time<1ms TTL=128
  Reply from 127.0.0.1: bytes=32 time<1ms TTL=128
  Reply from 127.0.0.1: bytes=32 time=1ms TTL=128
  
  Ping statistics for 127.0.0.1:
      Packets: Sent = 3, Received = 3, Lost = 0 (0% loss),
  Approximate round trip times in milli-seconds:
      Minimum = 0ms, Maximum = 1ms, Average = 0ms
  Control-C
  ^C
  C:\>
  ```

  如果 Ping 显示有数据包丢失，则可能有其他软件（如本地防火墙、安全设置或反恶意软件程序）阻止了您的连接。
+ **您的应用程序在运行吗？** 对于每个应用程序，您的本地模拟在单独的窗口中运行。确保空间应用程序和 `ViewApp` 的窗口处于打开状态。有关更多信息，请参阅 [当地发展 SimSpace Weaver](working-with_local-development.md)。
+ **您使用的 IP 地址和端口号是否正确？** 在连接到本地模拟时必须使用 `tcp://127.0.0.1:7000`。有关更多信息，请参阅 [当地发展 SimSpace Weaver](working-with_local-development.md)。
+ **您有可能阻止连接的本地安全软件吗？** 检查您的安全设置、本地防火墙或反恶意软件程序，看看它们是否阻止了您与 TCP 端口 `7000` 上 `127.0.0.1` 的连接。

# 他们认 AWS CLI 不出来 `simspaceweaver`
<a name="troubleshooting_old-cli"></a>

如果 AWS CLI 给出的错误提示它不知道 SimSpace Weaver，请运行以下命令。

```
aws simspaceweaver help
```

如果您收到以以下几行开头并列出所有可用选项的错误，则 AWS CLI 可能是旧版本。

```
usage: aws [options] <command> <subcommand> [<subcommand> ...] [parameters]
To see help text, you can run:

  aws help
  aws <command> help
  aws <command> <subcommand> help

aws: error: argument command: Invalid choice, valid choices are:
```

运行以下命令以检查您的版本 AWS CLI。

```
aws --version
```

如果版本低于 2.9.19，则必须更新您的 AWS CLI。请注意，的当前版本晚 AWS CLI 于 2.9.19。

要更新您的 AWS CLI，请参阅[版本 2 AWS Command Line Interface 用户指南 AWS CLI中的安装或更新最新](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)*版本的*。