> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 故障排除

## 登录问题

要访问 Qualcomm Software Center（网页[门户](https://softwarecenter.qualcomm.com/)和桌面应用程序），您需要一个
Qualcomm ID。请在 [https://myaccount.qualcomm.com/signup.](https://myaccount.qualcomm.com/signup.) 注册。

如果您使用正确的 Qualcomm ID 凭据登录 Qualcomm Software Center 桌面应用程序时遇到问题，请查看防火墙要求，
以确保您的网络与 Qualcomm 服务器之间的连接正常。

## 防火墙要求

QSC 服务器需要访问以下 URL：

* [https://apigwx-aws.qualcomm.com](https://apigwx-aws.qualcomm.com)（端口 443）
* [https://d1fmewm8udj8en.cloudfront.net](https://d1fmewm8udj8en.cloudfront.net)（端口 443）
* [https://dvbe2v39djgxg.cloudfront.net/](https://dvbe2v39djgxg.cloudfront.net/)（端口 443）
* [https://d1k9x1hli7v4r5.cloudfront.net/](https://d1k9x1hli7v4r5.cloudfront.net/)（端口 443）
* （可选，推荐位于中国的用户使用）[https://qpm.chinacloudfront.qualcomm.com](https://qpm.chinacloudfront.qualcomm.com)（端口 443）

运行以下命令检查 DNS 和防火墙问题。

1. 验证客户端能否通过 DNS 解析 API 端点。

   .. container:: nohighlight

<pre>nslookup apigwx-aws.qualcomm.com</pre>
**示例输出**

<img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/Qualcomm-Software-Center/images/output_nslookup_apigwx.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=ba80a7463913d4bf5bb7f5de6bca4d09" alt="nslookup_apigwx" style={{ width: '100%' }} width="651" height="164" data-path="Tools/Qualcomm-Software-Center/images/output_nslookup_apigwx.png" />

1. 检查连接。

   .. container:: nohighlight

<pre>curl -v [https://apigwx-aws.qualcomm.com](https://apigwx-aws.qualcomm.com)</pre>
**示例输出**

.. container:: nohighlight

<pre>Rebuilt URL to: [https://apigwx-aws.qualcomm.com/](https://apigwx-aws.qualcomm.com/)
timeout on name lookup is not supported
Trying x.x.x.x...
TCP\_NODELAY set
Connected to apigwx-aws.qualcomm.com (x.x.x.x) port
443 (#0)
schannel: SSL/TLS connection with
apigwx-aws.qualcomm.com port 443 (step 1/3)
schannel: checking server certificate revocation
...
schannel: SSL/TLS handshake complete
schannel: SSL/TLS connection with
apigwx-aws.qualcomm.com port 443 (step 3/3)
schannel: stored credential handle in session cache
GET / HTTP/1.1
Connection #0 to host apigwx-aws.qualcomm.com left intact</pre>

### Linux 客户端故障排除

请按以下顺序测试这些步骤。如果某一步成功完成，请继续下一个测试。

1. 验证客户端能否通过 DNS 解析 API 端点。

   * 在 Linux 终端中，输入 `nslookup` 并按 **Enter**。

   * 输入 API 端点 `apigwx-aws.qualcomm.com` 并按 **Enter**。

     预期响应是类似下图的 IP 列表。

     .. figure:: ../images/nslookup\_linux.png
     :alt: nslookup
     :scale: 60

   如果没有返回任何 IP，请联系贵公司的 DNS 团队，排查客户端无法解析 `apigwx-aws.qualcomm.com` 的问题或客户端 DNS 的问题。

2. 验证客户端能否通过 Ping 到达 API 端点。

   * 在 Linux 终端中输入 `ping apigwx-aws.qualcomm.com`。
   * 五到十秒后按 Ctrl + C 停止 ping 测试。

     下图显示了零丢包的响应。

     <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/Qualcomm-Software-Center/images/ping_linux.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=bccbcd157d8ae449c3ca22c06d122711" alt="ping_linux" style={{ width: '100%' }} width="983" height="170" data-path="Tools/Qualcomm-Software-Center/images/ping_linux.png" />

   如果数据包丢失或未收到，请联系您的网络团队，通过 Ping 排查 `apigwx-aws.qualcomm.com` 的问题。

3. 验证客户端能否通过 Telnet 到达 API 端点。

   * 在 Linux 终端中，输入 `telnet apigwx-aws.qualcomm.com 443`。

     预期会显示 `Connected to *****.cloudfront.net` 消息。

   * 按 Ctrl + C 关闭连接。

   如果出现 `connection failed` 或 `timed out` 消息，请联系您的网络团队，从您的客户端通过 Telnet 排查
   `apigwx-aws.qualcomm.com` 的问题。

### Windows 客户端故障排除

请按顺序测试这些步骤。如果某一步成功完成，请进行下一个测试。

1. 验证客户端能否通过 DNS 解析 API 端点

   * 打开 Windows 命令提示符。
   * 输入 `nslookup` 并按 **Enter**。
   * 输入 API 端点 \ [apigwx-aws.qualcomm.com](http://apigwx-aws.qualcomm.com/)\ 并按 Enter。

     预期响应是类似下图的 IP 列表。

<img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/Qualcomm-Software-Center/images/nslookup_windows.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=e2162d85b84abe4b3c1598aadbc14271" alt="nslookup_windows" style={{ width: '100%' }} width="448" height="315" data-path="Tools/Qualcomm-Software-Center/images/nslookup_windows.png" />

如果没有返回任何 IP，请联系贵公司的 DNS 团队，排查客户端无法解析 `apigwx-aws.qualcomm.com` 的问题或客户端 DNS 的任何问题。

1. 验证客户端能否通过 Ping 到达 API 端点

   * 打开 Windows 命令提示符。
   * 输入 `ping apigwx-aws.qualcomm.com`。

     预期响应显示零丢包，如下图所示。

     .. figure:: ../images/ping\_windows.png
     :alt: nslookup response
     :scale: 70

   如果数据包丢失或未收到，请联系您的网络团队，通过 Ping 排查 `apigwx-aws.qualcomm.com` 的问题。

2. 验证客户端能否通过 Tracert 到达 API 端点

   * 打开 Windows 命令提示符。

   .. \_api\_endpoint\_step\_two:

   * 输入 `tracert apigwx-aws.qualcomm.com`。

     预期响应以 `Tracing route to XXXXXX.cloudfront.net [IP address]` 消息开始。

     跟踪路由显示从[步骤 2](https://docs.qualcomm.com/doc/80-72780-2/topic/troubleshooting.html?product=895724676033554725\&facet=Qualcomm%20Software%20Center\&version=2.0-rc2#api-endpoint-step-two) 到达端点所经过的互联网路由。

     以下是预期响应的示例。

<img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/Qualcomm-Software-Center/images/tracertWindows.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=6aa1206a2b79dbe21be6b3685a76ed17" alt="tracertWindows.png" style={{ width: '100%' }} width="882" height="579" data-path="Tools/Qualcomm-Software-Center/images/tracertWindows.png" />

出现一些超时是正常的。

如果存在连接问题，例如最后一跳未能到达[步骤 2](https://docs.qualcomm.com/doc/80-72780-2/topic/troubleshooting.html?product=895724676033554725\&facet=Qualcomm%20Software%20Center\&version=2.0-rc2#api-endpoint-step-two) 中的端点，则说明客户端到 `apigwx-aws.qualcomm.com` 端点的路由存在问题。请联系您的 IT 团队，并附上 `client cannot route to the apigwx-aws.qualcomm.com Qualcomm endpoint` 消息的示例。

## Windows (WSL) 上的 QSC Launcher 删除文件后磁盘空间未回收

在 WSL 内部删除文件后，虚拟磁盘 (`ext4.vhdx`) 有时不会缩小，Windows 仍显示较高的磁盘使用率。这是因为 WSL 使用虚拟磁盘文件来存储 Linux 文件系统。在 WSL 内部删除文件时，空间在内部被释放，但 VHDX 文件大小保持不变，因为 Windows 不会自动压缩它。要解决此问题，请手动压缩 VHDX 文件。

1. 使用以下命令关闭 WSL。

   .. container:: nohighlight

<pre>wsl --shutdown</pre>

1. 找到 VHDX 文件。

   默认位置是 `%USERPROFILE%\AppData\Local\Packages\&lt;Distro&gt;\LocalState\ext4.vhdx`。

2. 使用 Hyper V 工具或 diskpart 压缩磁盘。

   .. list-table::

   *
   * **Hyper V 工具**
   * 在启用了 Hyper V 功能的情况下使用 PowerShell：

     .. container:: nohighlight

## <pre>Optimize-VHD -Path "C:\Path\To\ext4.vhdx" -Mode Full</pre>

* **diskpart**
* 使用 PowerShell：

  .. container:: nohighlight

<pre>DiskPart
Select vdisk file="C:\Path\To\ext4.vhdx"
compact vdisk
exit</pre>

1. 使用以下命令在执行这些步骤前后验证文件大小。

   .. container:: nohighlight

<pre>Get-Item "C:\Path\To\ext4.vhdx" | Select-Object Length</pre>
为防止此问题再次发生：

* 在大量删除后定期运行 Optimize-VHD。
* 避免在 WSL 内部存储大型临时文件。
* 对临时数据使用挂载的 Windows 目录。

## 联系支持

有关技术问题，请访问[支持站点](https://mysupport.qualcomm.com/software-center)。

如需帮助或对本文档中的信息进行澄清，请在 [https://support.qualcomm.com/.](https://support.qualcomm.com/.) 提交技术支持工单。您需要注册 Qualcomm ID 账户，并且贵公司必须启用支持才能访问工单系统。

提交支持工单报告问题时，请包含以下信息：

* 主机操作系统详细信息
* Qualcomm Software Center 桌面应用程序的版本
* 问题的详细信息以及准确的重现步骤
* 相关的 UI 截图
* 日志

  要在 Qualcomm Software Center 桌面应用程序中收集日志，请转到帮助菜单 > **Download Logs** > 选择日期范围 > **Download**。

<Note>
  日志也可以从下面列出的位置手动收集。
</Note>

Linux

* `/var/tmp/qcom/softwarecenter/logs`
* `/var/tmp/qcom/qik/logs`

Windows

* `C:\ProgramData\Qualcomm\SoftwareCenter\Logs`
* `%temp%\QIK\Logs`
* `%temp%\Qualcomm\QIK\Logs`

其他系统和支持资源列于 [https://qualcomm.com/support.](https://qualcomm.com/support.)。如需进一步帮助，请发送电子邮件至 [qualcomm.support@qti.qualcomm.com](mailto:qualcomm.support%40qti.qualcomm.com)。