Skip to content

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

问题现象 ​

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

已知限制:RunCode 使用独立的 Jupyter /execute 端点,暂未被该诊断覆盖——误路由的 200 HTML 页面被喂给其流解析器后,表现为返回空结果且无错误(见 #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 主机上,可按实际部署使用本机节点地址。

参考资料 ​