终止支持通知：2026 年 5 月 31 日， AWS 将终止对的支持。 AWS Panorama 2026 年 5 月 31 日之后，您将无法再访问 AWS Panorama 控制台或 AWS Panorama 资源。有关更多信息，请参阅[AWS Panorama 终止支持](https://docs.aws.amazon.com/panorama/latest/dev/panorama-end-of-support.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 故障排除
以下主题针对您在使用 AWS Panorama 控制台、设备或 SDK 时可能遇到的错误和问题提供了故障排除建议。如果您发现某个问题未在此处列出，请使用此页面上的**提供反馈**按钮进行报告。
您可以在 [Amazon Logs 控制台中查找设备的 CloudWatch 日志](https://console.aws.amazon.com/cloudwatch/home#logsV2:log-groups)。设备在生成应用程序代码、设备软件和 AWS IoT 进程时上传日志。有关更多信息，请参阅 [查看 AWS Panorama 日志](monitoring-logging.md)。
## 预置
**问题：**(macOS) *我的计算机无法识别带有 USB-C 适配器的 USB 驱动器。*
如果将 USB 驱动器插入已连接到计算机的 USB-C 适配器，则可能会发生这种情况。尝试断开适配器，然后将其与已连接的 USB 驱动器重新连接。
**问题：***当我使用自己的 USB 驱动器时，预置失败。*
**问题：***使用设备的 USB 2.0 端口时，预置失败。*
本 AWS Panorama 设备与 1 到 32 GB 的 USB 闪存设备兼容，但并非所有设备都兼容。使用 USB 2.0 端口进行预置时，已观察到一些问题。为了获得一致的结果，请使用附带的 USB 驱动器和 USB 3.0 端口（靠近 HDMI 端口）。
对于联想 ThinkEdge® SE7 0，设备中不包括USB驱动器。使用至少具有 1 GB 存储空间的 USB 3.0 驱动器。
## 设备配置
**问题：***设备在启动过程中显示空白屏幕。*
完成初始启动序列（大约需要一分钟）后，设备会在加载模型并启动应用程序时显示一分钟或更长时间的空白屏幕。此外，如果在显示器打开后连接显示器，设备不会输出视频。
**问题：***当我按住电源按钮将其关闭时，设备没有响应。*
设备最多需要 10 秒才能安全关闭。您只需按住电源按钮 1 秒钟即可开始关机序列。有关按钮操作的完整列表，请参阅 [AWS Panorama 设备按钮和指示灯](appliance-buttons.md)。
**问题：***我需要生成新的配置存档来更改设置或替换丢失的证书。*
AWS Panorama 下载设备证书或网络配置后不会存储它们，并且您无法重复使用配置存档。使用 AWS Panorama 控制台删除设备，然后使用新的配置存档创建一个新设备。
## 应用程序配置
**问题：***当我运行多个应用程序时，我无法控制哪个应用程序使用 HDMI 输出。*
部署具有输出节点的多个应用程序时，最近启动的应用程序将使用 HDMI 输出。如果此应用程序停止运行，则另一个应用程序可以使用该输出。要仅授予一个应用程序访问输出的权限，请从另一个应用程序的[应用程序清单](applications-manifest.md)中删除输出节点和相应的边缘，然后重新部署。
**问题：***应用程序输出未显示在日志中*
[配置 Python 记录器](monitoring-logging.md#monitoring-logging-configuration)以将日志文件写入 `/opt/aws/panorama/logs`。这些内容在代码容器节点的日志流中捕获。标准输出和错误流在名为 `console-output` 的单独日志流中捕获。如果使用 `print`，请使用 `flush=True` 选项来防止消息卡在输出缓冲区中。
**错误：***You've reached the maximum number of versions for package SAMPLE\$1CODE. Deregister unused package versions and try again.*
**来源：** AWS Panorama 服务
每次对应用程序进行更改时，都会注册一个*补丁版本*，该补丁版本表示它使用的每个包的包配置和资产文件。使用[清理补丁脚本](panorama-samples.md#samples-scripts)取消注册未使用的补丁版本。
## 相机流式传输
**错误：***liveMedia0: Failed to get SDP description: Connection to server failed: Connection timed out (-115)*
**错误：***liveMedia0: Failed to get SDP description: 404 Not Found; with the result code: 404*
**错误：***liveMedia0: Failed to get SDP description: DESCRIBE send() failed: Broken pipe; with the result code: -32*
**来源：**相机节点日志
设备无法连接到应用程序的相机流式传输。发生这种情况时，当应用程序等待来自应用程序 SDK 的视频帧时，视频输出为空白或在最后处理的帧上冻结。 AWS Panorama 设备软件尝试连接到相机流并在摄像机节点日志中记录超时错误。验证您的摄像头流 URL 是否正确，以及 RTSP 流量是否可在网络内的摄像头和设备之间路由。有关更多信息，请参阅 [将 AWS Panorama Appliance 连接到您的网络](appliance-network.md)。
**错误：***ERROR finalizeInterface(35) Camera credential fetching for port [username] failed*
**来源：**OCC 日志
找不到摄像机直播凭据的 AWS Secrets Manager 秘密。删除相机流并重新创建它。
**错误：***Camera did not provide an H264 encoded stream*
**来源：**相机节点日志
相机流具有 H.264 以外的编码，例如 H.265。使用 H.264 相机流重新部署应用程序。有关支持的相机的详细信息，请参阅 [支持的摄像头](gettingstarted-compatibility.md#gettingstarted-compatibility-cameras)。