---
url: https://cubesandbox.com/zh/guide/troubleshooting/sdk-connect-stream-routing.md
---

# Go SDK Connect 流返回 HTML 或文本响应

## 问题现象

调用 `Commands.Run`、`Files.WatchDir` 或 `Pty.Create` 等 Go SDK 接口时，出现 HTML/文本响应、无效 Connect 信封或消息过大的错误。实际返回内容可能是浏览器登录页、网关错误页、JSON 响应或被压缩的响应，而不是 Connect 流数据。

已知限制：`RunCode` 使用独立的 Jupyter `/execute` 端点，暂未被该诊断覆盖——误路由的 200 HTML 页面被喂给其流解析器后，表现为返回空结果且无错误（见 [#1759](https://github.com/TencentCloud/CubeSandbox/issues/1759)）。纯 HTTP 的 `Files.Read`/`Files.Write` 路径同样未覆盖：误路由的 200 HTML 页面会被 `readFile` 当作文件内容返回，`writeFile` 则把任何低于 400 的状态码都视为成功。

## 适用环境

* 通过 CubeProxy 发起的 Go SDK Connect 流式调用
* 数据面配置：`CUBE_PROXY_NODE_IP`、`CUBE_PROXY_PORT_HTTP` 和 `CUBE_SANDBOX_DOMAIN`

## 根因分析

SDK 的数据面请求必须到达 CubeProxy 的流式端点。当设置了 `CUBE_PROXY_NODE_IP` 时，它必须指向客户端可达的 CubeProxy 节点；未设置时，客户端必须能将 `*.<CUBE_SANDBOX_DOMAIN>` 解析到 CubeProxy。若两者都不成立，或路由被 Web 服务或网关接管，返回内容就不是 Connect 帧格式。

## 解决方案

1. 如果设置了 `CUBE_PROXY_NODE_IP`，请确认它指向客户端可达的 CubeProxy 节点 IP：

   ```bash
   export CUBE_PROXY_NODE_IP=<cubeproxy-node-ip>
   ```

   未设置时，请确认客户端能将 `*.<CUBE_SANDBOX_DOMAIN>` 解析到 CubeProxy。

2. 确认 `CUBE_PROXY_PORT_HTTP` 和沙箱域名与 CubeProxy 配置一致。

3. 确认请求发送到了数据面端点，并检查中间网关没有重写或压缩流式响应。

4. 重试 SDK 调用。HTML 页面和 404 文本页会附带端点配置提示；其他文本错误保留服务器原始消息。

远程客户端还需要确认到 CubeProxy 节点的防火墙规则和网络路由。SDK 若运行在 CubeProxy 主机上，可按实际部署使用本机节点地址。

## 参考资料

* 关联 Issue：[#1759](https://github.com/TencentCloud/CubeSandbox/issues/1759)
