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

# 对 WorkSpaces 应用程序用户问题进行故障排除
<a name="troubleshooting-user-issues"></a>

## 启用高级日志记录
<a name="troubleshooting-advanced-logging"></a>

为了帮助解决用户可能遇到的问题，您可以在任何 A WorkSpaces pplications 客户端上启用高级日志记录。高级日志记录将生成包含诊断信息和调试级别详细信息（包括详细的性能数据）的日志文件。

**注意**  
要 AWS 查看高级日志文件并获得有关 WorkSpaces 应用程序客户端问题的技术支持，请联系 支持。有关更多信息，请参阅[AWS Support Center Console](https://console.aws.amazon.com/support/home#/)。

### 为 Web 访问启用高级日志记录
<a name="troubleshooting-advanced-logging-web"></a>

如果用户正在使用 SAML、用户池或有权访问“应用程序目录”页面，请按照以下步骤操作：

1. 加载目录页面。

1. 打开**开发人员工具**，然后选择**控制台**选项卡。

1. 在浏览器控制台中，输入 **window.siteConfig.logLevel = "INFO"** 并选择 **Enter**。

1. 启动应用程序，您应该会在**控制台**选项卡上看到**日志记录**。

1. 重现问题。

1. 右键单击**控制台**选项卡，然后选择**将所有消息保存到文件**。

### 为 Windows 客户端启用高级日志记录
<a name="troubleshooting-advanced-logging-windows"></a>

要为 Windows 客户端启用高级日志记录，请完成以下步骤：

1. 在客户端计算机上，转至 `%localappdata%\AppStreamClient\app-<versionID>`。

1. 在 Notepad 中打开 `Log4Net.config`。

1. 将日志记录的根级别从 **INFO** 更改为 **DEBUG**。

1. 保存该文件。

1. 重新启动 WorkSpaces 应用程序客户端，然后再次尝试连接。

1. 压缩完整文件夹 `C:\Users\%USERNAME%\AppData\Local\Amazon\AppStreamClient\'`，从中收集日志。

以下是您的用户在使用 WorkSpaces 应用程序时可能遇到的具体问题。

**Topics**
+ [启用高级日志记录](#troubleshooting-advanced-logging)
+ [我的用户 WorkSpaces 应用程序客户端安装失败，他们收到一条消息，指出需要.NET Framework 4.6。](#troubleshooting-client-no-internet-net-framework-462-fails)
+ [我的用户在安装 WorkSpaces 应用程序客户端时安装的 USB 驱动程序失败，现在他们无法将 USB 设备与 WorkSpaces 应用程序一起使用。](#troubleshooting-client-no-internet-usb-driver-install-fails)
+ [我的 WorkSpaces 应用程序客户端用户每 60 分钟就会断开与 WorkSpaces 应用程序会话的连接。](#troubleshooting-client-users-disconnected-every-60-minutes)
+ [我的用户无法在本地设备与流式传输会话之间复制并粘贴。](#copy-paste-doesnt-work)
+ [在流式传输会话期间，有些键盘快捷键对用户不起作用。](#keyboard-shortcuts-dont-work)
+ [我的用户的绘图板不适用于我部署的流应用程序。](#troubleshooting-client-users-drawing-tablets-not-working)
+ [我的用户在流式传输会话期间无法使用日语输入法](#japanese-language-input-method-doesnt-work-for-users)
+ [当我的用户尝试从应用程序目录启动应用程序时，他们看到错误，指出已达到最大流式传输会话数。](#troubleshooting-max-sessions)
+ [我的用户看到黑屏或桌面，但他们的应用程序无法在弹性实例集上启动。未显示错误。](#troubleshooting-black-screen)

## 我的用户 WorkSpaces 应用程序客户端安装失败，他们收到一条消息，指出需要.NET Framework 4.6。
<a name="troubleshooting-client-no-internet-net-framework-462-fails"></a>

当用户安装 WorkSpaces 应用程序客户端时， WorkSpaces 应用程序还会安装.NET Framework 版本 4.6.2（如果尚未安装该版本或更高版本）。如果将客户端安装到的 PC 未连接到 Internet，则无法安装 .NET Framework。在此情况下，系统会显示一条消息，提示用户手动安装 .NET Framework 4.6 版。但是，当用户选择 **Install (安装)** 时，会显示一条错误消息，指明安装失败。之后，系统会提示用户尝试手动安装最新版本的 .NET Framework。当用户选择 **Close (关闭)** 时，他们将退出安装。

要解决此问题，用户必须从打算将客户端安装到的 PC 建立 Internet 连接，然后在同一台 PC 上下载并安装 .NET Framework 4.6.2 版或更高版本。有关可供下载的 .NET Framework 版本的列表，请参阅[下载 .NET Framework](https://dotnet.microsoft.com/download/dotnet-framework)。

**注意**  
安装了 1.1.156 版 WorkSpaces 应用程序客户端的用户必须在同一台电脑上安装.NET Framework 4.7.2 或更高版本。

## 我的用户在安装 WorkSpaces 应用程序客户端时安装的 USB 驱动程序失败，现在他们无法将 USB 设备与 WorkSpaces 应用程序一起使用。
<a name="troubleshooting-client-no-internet-usb-driver-install-fails"></a>

当用户安装 WorkSpaces 应用程序客户端时，他们会选择是否安装 WorkSpaces 应用程序 USB 驱动程序。需要驱动程序才能将 USB 设备与通过应用程序流式传输的 WorkSpaces 应用程序一起使用。但是，如果发生以下两种情况，则无法安装 USB 驱动程序：
+ Windows 证书存储中没有用于对 `AppStreamUsbDriver.exe` 文件进行签名的根证书。
+ 将客户端安装到的 PC 未连接到 Internet。

在这种情况下，无法验证 Amazon AppStream USB 驱动程序的证书，并且会显示一条错误消息通知用户 USB 驱动程序安装失败。当用户选择 “**确定”** 时， WorkSpaces 将在没有 USB 驱动程序的情况下完成应用程序客户端安装。尽管用户仍然可以使用 WorkSpaces 应用程序客户端进行应用程序流式传输，但他们的 USB 设备无法与通过 WorkSpaces 应用程序流式传输的应用程序配合使用。

要解决此问题，用户必须与计划安装 WorkSpaces 应用程序客户端的电脑建立互联网连接，然后重新安装客户端。

## 我的 WorkSpaces 应用程序客户端用户每 60 分钟就会断开与 WorkSpaces 应用程序会话的连接。
<a name="troubleshooting-client-users-disconnected-every-60-minutes"></a>

如果您已使用 SAML 2.0 配置身份联合来访问 WorkSpaces 应用程序，则可能需要配置 IdP 在身份验证响应中作为 SAML 属性 AWS 传递的信息，具体取决于您的身份提供商 (IdP)。这包括配置 **Attribute (属性)** 元素，并将 `SessionDuration` 属性设置为 `https://aws.amazon.com/SAML/Attributes/SessionDuration`。

`SessionDuration` 指定用户的联合流式传输会话在需要重新进行身份验证之前可保持活动状态的最长时间。虽然 `SessionDuration` 是可选属性，但建议您将它包含在 SAML 身份验证响应中。如果您未指定此属性，则会话持续时间将设置为默认值 60 分钟。

要解决此问题，请配置与 SAML 的兼容 IdP 以在 SAML 身份验证响应中包含 `SessionDuration` 值，并根据需要设置该值。有关更多信息，请参阅 [步骤 5：为 SAML 身份验证响应创建断言](external-identity-providers-setting-up-saml.md#external-identity-providers-create-assertions)。

**注意**  
如果您的用户使用应用程序原生客户端或在 WorkSpaces 新的体验中使用 Web 浏览器访问其 WorkSpaces 应用程序中的流媒体应用程序，则他们的会话将在会话持续时间到期后断开连接。如果您的用户在旧/经典体验中使用网络浏览器访问其 WorkSpaces 应用程序中的流媒体应用程序，则在用户的会话持续时间到期并刷新浏览器页面后，他们的会话将断开连接。

如果您的用户使用兼容 SAML 的 IdP 登录新的门户体验，并且他们继续随机断开连接，则可能是由于应用程序会话使用的会话 Cookie 被用作子域的其他网络 WorkSpaces 应用程序失效。`aws.amazon.com`以下是两种常见情境：
+ 如果用户在同一个浏览器中启动新的 WorkSpaces 应用程序会话，则现有的 WorkSpaces 应用程序会话将断开连接。
+ 如果用户在同一个浏览器中启动任何其他 Web 应用程序，从而在该`aws.amazon.com`域下进行新的用户身份验证，则现有的 WorkSpaces 应用程序会话将断开连接。
+ 如果用户在同一浏览器中 AWS 管理控制台 使用新的 IAM 凭证登录，则现有 WorkSpaces 应用程序会话将断开连接。

您可以通过使用新的中继状态端点来配置您的 SAML 2.0 联合，以及使用 WorkSpaces 应用程序客户端版本 1.1.1300 及更高版本来解决此问题。有关更多信息，请参阅[步骤 6：配置您的联合身份验证的中继状态](external-identity-providers-setting-up-saml.md#external-identity-providers-relay-state)上的表 1。

## 我的用户无法在本地设备与流式传输会话之间复制并粘贴。
<a name="copy-paste-doesnt-work"></a>

WorkSpaces 应用程序利用 [W3C 规范](https://www.w3.org/TR/2017/WD-clipboard-apis-20170929/)在 Web 应用程序中启用异步剪贴板操作。这使用户能够在本地设备与流式传输会话之间复制并粘贴内容，其方式与在本地设备上的各应用程序之间复制并粘贴相同，包括使用键盘快捷键。

目前支持 W3C 异步剪贴板规范的唯一浏览器是 Google Chrome 66 版或更高版本，这仅支持复制并粘贴文本。对于所有其他浏览器，用户可以使用 WorkSpaces 应用程序门户网站中的剪贴板功能，该功能提供了一个用于复制或粘贴文本的对话框。

如果您的用户在流式传输会话期间使用剪贴板时遇到问题，您可以向他们提供以下信息：
+ **我使用的是 Chrome 66 版或更高版本，键盘快捷键不起作用。**

  Chrome 会显示一条提示，提示您选择是否允许 WorkSpaces 应用程序访问复制到剪贴板的内容。请选择 **Allow (允许)** 以允许粘贴到您的远程会话。如果您将文本从远程会话复制到本地设备，则 Chrome 应用程序和包含流式传输会话的选项卡都必须在您的本地设备上保持处于焦点足够长时间，才能从流式传输会话复制文本。少量文本应可以几乎立即复制，但对于大量文本，您可能需要等待 1 到 2 秒，然后再离开 Chrome 或包含流式传输会话的选项卡。复制文本所需的时间因网络条件而异。
+ **在尝试复制并粘贴大量文本时，复制并粘贴不起作用。**

  WorkSpaces 对于在本地设备和流媒体会话之间复制和粘贴的文本量，应用程序的默认限制为 20 MB。如果您尝试复制 20 MB 以上，则不会复制任何文本。但是，如果您的管理员设置了限制，而您超过了该限制，则文本将被截断。如果您尝试在本地设备上的各应用程序之间或在流式传输会话中的各应用程序之间复制并粘贴文本，此限制不适用。管理员还可以限制您进入 copy/paste /退出直播会话的角色数量。如果您需要在本地设备与流式传输会话之间复制或粘贴超过 20 MB 或指定限制的文本，可以将其拆分为较小的块，或者将其作为文件上传。
+ **我正在使用 WorkSpaces 应用程序门户网站的剪贴板功能将文本粘贴到我的直播会话中，但它不起作用。**

  在某些情况下，在将文本粘贴到剪贴板对话框中且该对话框关闭后，当您尝试使用键盘快捷键将文本粘贴在流式传输会话中时，什么也没有发生。发生此问题的原因是，当剪贴板对话框出现时，焦点离开了流应用程序。在该对话框关闭后，焦点可能不会自动返回到流应用程序。单击流应用程序应能够使焦点返回到它并使您能够使用键盘快捷键将文本粘贴到流式传输会话中。

## 在流式传输会话期间，有些键盘快捷键对用户不起作用。
<a name="keyboard-shortcuts-dont-work"></a>

以下键盘快捷键可在用户的本地计算机上使用，但不会传递到 WorkSpaces 应用程序流式传输会话：

Windows：
+ Win\$1L
+ Ctrl\$1Alt\$1Del

Mac：
+ Ctrl\$1F3 
+ 使用 Alt 或 Option 组合键的所有快捷键

出现此问题是由于用户的本地计算机上的以下限制：
+ 键盘快捷键由用户本地计算机上运行的操作系统进行筛选，不会传播到用户访问 WorkSpaces 应用程序时使用的浏览器。此行为适用于 Windows Win\$1L 和 Ctrl\$1Alt\$1Del 键盘快捷键以及 Mac Ctrl\$1F3 键盘快捷键。
+ 当用于 Web 应用程序时，有些键盘快捷键被浏览器筛除，没有为 Web 应用程序生成事件。因此，Web 应用程序无法响应用户键入的键盘快捷键。
+ 在生成键盘事件之前，键盘快捷键由浏览器进行转换，而有些快捷键没有正确转换。例如，Mac 计算机上的 Alt 组合键和 Option 组合键被转换成了 Windows 上的 Alt Graph 组合键。在发生此情况时，当用户使用这些组合键时，结果不会与用户的预期一样。

## 我的用户的绘图板不适用于我部署的流应用程序。
<a name="troubleshooting-client-users-drawing-tablets-not-working"></a>

如果用户的绘图板不适用于流应用程序，请确保满足要求并了解启用此功能的其他注意事项。以下是允许您的用户在 WorkSpaces 应用程序流式传输会话期间使用绘图板的要求和注意事项。

**注意**  
使用应用程序客户端或通过支持的 Web 浏览器访问 WorkSpaces WorkSpaces 应用程序的用户支持绘图板。
+ 要让您的用户能够使用此功能，您必须将 WorkSpaces 应用程序群配置为使用运行 Windows Server 2019 的映像。
+ 要使用此功能，用户必须使用 WorkSpaces WorkSpaces 应用程序客户端，或者只能通过谷歌浏览器或Mozilla Firefox浏览器访问应用程序。
+ 流应用程序必须支持 Windows Ink 技术。有关更多信息，请参阅 [Windows 应用程序中的手写笔交互和 Windows Ink](https://docs.microsoft.com/en-us/windows/uwp/design/input/pen-and-stylus-interactions)。
+ 某些应用程序（如 GIMP）必须检测流实例上的绘图板以支持压力敏感性。在这种情况下，您的用户必须使用 WorkSpaces 应用程序客户端来访问 WorkSpaces 应用程序并流式传输这些应用程序。此外，您必须符合用户绘图板的资格，并且用户每次开始新的直播会话时都必须与 WorkSpaces 应用程序共享绘图板。
+ Chromebook 不支持此功能。

## 我的用户在流式传输会话期间无法使用日语输入法
<a name="japanese-language-input-method-doesnt-work-for-users"></a>

要让您的用户能够在 WorkSpaces 应用程序流式传输会话期间使用日语输入法，请执行以下操作：
+ 将您的实例集配置为使用日语输入法。为此，请在创建映像时在映像生成器上启用日语输入法，然后将实例集配置为使用该映像。有关更多信息，请参阅 [指定默认输入法](configure-default-input-method.md)。这样， WorkSpaces 应用程序就可以自动将您的图像配置为使用日语键盘。有关更多信息，请参阅 [日语键盘](special-considerations-japanese-language-settings.md#special-considerations-japanese-language-keyboards)。
+ 确保在用户的本地计算机上也启用了日语输入法。

如果实例集实例和用户的本地计算机不使用相同的语言输入法，这种不匹配可能会导致在用户流式传输会话期间实例集实例上出现意外的键盘输入。例如，如果实例集实例使用日语输入法，而用户的本地计算机使用英语输入法，则在流式传输会话期间，本地计算机将向实例集实例发送与实例集实例具有不同键映射的键。

要验证实例集实例是否启用了日语输入法，请为实例集启用**桌面**流视图。有关更多信息，请参阅[在 Amazon WorkSpaces 应用程序中创建舰队](set-up-stacks-fleets-create.md)中的步骤 6。

### Windows 键盘快捷键
<a name="japanese-language-input-method-windows-keyboard-shortcuts"></a>

以下是用于切换日语输入模式和日语转换的 Windows 键盘快捷键。要使这些键盘快捷键起作用， WorkSpaces 应用程序流式传输会话必须处于活动状态。

**用于切换日语输入模式的 Windows 键盘快捷键**


| 键盘快捷键 | 说明 | 
| --- | --- | 
|  半角/全角/漢字 (Hankaku/Zenkaku/Kanji) 或者 Alt\$1`  |  在字母数字和日语模式之间切换输入模式  | 
|  無変換 （Muhenkan）  |  依次将字符转换为平假名、全角片假名和半角片假名  | 
|  カタカナ/ひらがな/ローマ字 (Katakana/Hiragana/Romaji)  |  将输入模式更改为平假名  | 
|  Shift\$1カタカナ/ひらがな/ローマ字 (Katakana/Hiragana/Romaji)  |  将输入模式更改为片假名  | 
|  Alt\$1カタカナ/ひらがな/ローマ字  (Katakana/Hiragana/Romaji)  |  在日语罗马字和日语假名之间切换输入模式  | 

**用于日语转换的 Windows 键盘快捷键**


| 键盘快捷键 | 说明 | 
| --- | --- | 
|  変換（Henkan）\$1 Space  |  列出转换选项  | 
|  F6  |  转换为平假名  | 
|  F7  |  转换为全角片假名  | 
|  F8  |  转换为半角片假名  | 
|  F9  |  转换为全角罗马字  | 
|  F10  |  转换为半角罗马字  | 

### Mac 键盘快捷键
<a name="japanese-language-input-method-mac-keyboard-shortcuts"></a>

有关用于切换日语输入法和日语转换的 Mac 键盘快捷键的信息，请参阅 Mac 支持文档中的以下文章。

**注意**  
由于 WorkSpaces 应用程序流式传输会话在 Windows 实例上运行，因此 Mac 用户可能会遇到不同的按键映射。
+ 用于切换日语输入法的键盘快捷键 – [在 Mac 上设置并切换到日语输入源](https://support.apple.com/guide/japanese-input-method/set-up-and-switch-to-japanese-jpim10267/mac)
+ 用于日语转换的键盘快捷键 – [Mac 上用于日语转换的键盘快捷键](https://support.apple.com/guide/japanese-input-method/keyboard-shortcuts-jpim10263/6.2.1/mac)

## 当我的用户尝试从应用程序目录启动应用程序时，他们看到错误，指出已达到最大流式传输会话数。
<a name="troubleshooting-max-sessions"></a>

使用 A WorkSpaces pplications Elastic 队列，您可以使用最大并发参数指定可以同时进行直播的最大用户数。任何尝试流式传输数量超过该值的用户都会收到此错误。要解决此问题，您可以增加并发流的最大数量，或者建议您的用户等待其他用户完成流式传输会话。

**注意**  
您可能需要申请提高限制来提高实例类型和大小限制。

## 我的用户看到黑屏或桌面，但他们的应用程序无法在弹性实例集上启动。未显示错误。
<a name="troubleshooting-black-screen"></a>

如果应用程序启动路径不正确，且 AppStream 2.0 无法启动应用程序，则可能会发生这种情况。您可以使用桌面视图在实例集上浏览根卷来验证应用程序的启动路径。验证指定的路径中存在应用程序可执行文件。

如果您无法在流媒体实例上找到应用块的 VHD 或设置脚本，则 AppStream 2.0 可能无法从 S3 存储桶下载它们。验证您指定的 VPC 可以访问 S3。有关更多信息，请参阅 [将 Amazon S3 VPC 终端节点用于 WorkSpaces 应用程序功能](managing-network-vpce-iam-policy.md)。