如何對在使用 Amazon Q Business 時收到的「伺服器停止回應」錯誤進行疑難排解？

解決方法

當 Amazon Q Business 無法建立所需的網路連線時，就會出現「伺服器停止回應」錯誤訊息。Amazon Q Business 透過連接埠 8443，使用 WebSocket 技術來維持與端點 (例如 wss://qbusiness.{region}.api.aws:8443/chat) 的安全通訊。為了使 Web 體驗正常運作，連接埠 8443 必須開放並且可供您的網路存取。

若要確認問題是否由連接埠存取性造成的，請系統性地測試連線。

**注意：**如果您的網路使用 VPN 或防火牆，請務必在開啟和關閉 VPN 或防火牆的情況下測試連線。

測試 WebSocket 連線

如果是 macOS 或 Linux，請使用終端執行下列命令：

nc -v qbusiness.us-east-1.api.aws 8443

成功連線範例：

Connection to qbusiness.us-east-1.api.aws port 8443 [tcp/pcsync-https] succeeded

如果是 Windows，請使用 Windows PowerShell 執行下列命令：

Test-NetConnection -ComputerName qbusiness.us-east-1.api.aws -Port 8443

成功連線範例：

ComputerName     : qbusiness.us-east-1.api.aws
RemoteAddress    : 34.192.X.X
RemotePort       : 8443
InterfaceAlias   : Wi-Fi
SourceAddress    : 10.0.X.X
TcpTestSucceeded : True

- 或 -

使用 PIE.host 網站上的 WebSocket 測試器來測試連線。輸入您的端點，然後選擇 Connect (連線)。

網路測試成功會在輸出中顯示連線已建立。您也可能會看到連線已關閉訊息，這表示您的用戶端電腦已成功透過連接埠 8443 連線至該端點。

如果測試失敗，請確定連接埠 8443 已開啟且可存取。更新網路的 VPN、虛擬私有雲端 (VPC)，或防火牆政策中的設定。如果您無法存取所需設定，請聯絡您的網路管理員尋求協助。

如果連接埠測試成功，但您仍然收到錯誤訊息，則 WebSocket 連線可能遭到封鎖。

若要確定錯誤的原因，請完成以下步驟：

1. 按 F12 開啟瀏覽器的網路主控台。
2. 在 Amazon Q Business 應用程式中提出請求。
3. 檢閱主控台日誌是否存在 WebSocket 連線錯誤。

遭到封鎖的 WebSocket 連線會顯示類似以下錯誤訊息：

「WebSocket 連線到 ‘wss://qbusiness.us-east-1.api.aws:8443/chat?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=XXXXXXXXXC2MH5KBV FMS%2F20241231%2Fus-east-1%2Fqbusiness%2Faws4_request&X-Amz-Date=20241231T151549Z&X-Amz-Expires=900&X-Amz-failed’」

如果您看到上述訊息，請聯絡您的網路管理員以解除網路連線封鎖。

相關資訊

使用 Amazon Q Business Web 體驗