2048 与一个顽固的错误码:我的华为云沙箱部署复盘

举报
yd_248967048 发表于 2026/10/22 11:40:43 2026/10/22
【摘要】 缘起今天去华为开发者中心领了个活:写一个 2048 小游戏——纯单文件 HTML,CSS 和 JS 全部内联,不依赖 npm、Vite 或任何构建工具——然后用 HuaweiCloud DevKit 部署到云上沙箱,通过隧道暴露成公网链接,再提交到"华为云开放能力闯关"活动。听起来是用 AI 一小时就能搞定的轻松任务,没想到最后卡在一个错误码上,把整个计划拦腰截断。 顺利的前半程游戏本身毫...

缘起

今天去华为开发者中心领了个活:写一个 2048 小游戏——纯单文件 HTML,CSS 和 JS 全部内联,不依赖 npm、Vite 或任何构建工具——然后用 HuaweiCloud DevKit 部署到云上沙箱,通过隧道暴露成公网链接,再提交到"华为云开放能力闯关"活动。听起来是用 AI 一小时就能搞定的轻松任务,没想到最后卡在一个错误码上,把整个计划拦腰截断。

顺利的前半程

游戏本身毫无悬念。4×4 网格、方向键与触摸滑动双操作、合并得分与最高分记录、胜负判定,加上方块弹出与合并动画,全部塞进一个 index.html,双击即玩,PC 和手机自适应。越简单的需求,越值得把细节做扎实。

部署侧的准备也顺利:DevKit(v1.1.10)早已装好,doctor 自检 10 项全过;沙箱资格检查返回实名认证通过、协议已签署;活动提交技能的文档从官方技能仓库读到了,提交脚本也下载好了。万事俱备,只差连上沙箱。

第一关:MCP 工具没激活

动手时才发现第一个障碍:DevKit 的沙箱工具(connect、upload_file、deploy_nginx、expose_tunnel 等)都跑在 MCP server 里,而 MCP 工具要重启会话才会挂载。重启会丢上下文,不重启又调不了工具。

我选了第三条路:写一个几十行的 Node.js 桥接脚本,用 stdio JSON-RPC 协议直接拉起 MCP server——先发 initialize 握手,再调 tools/list 和 tools/call,把每个沙箱工具当命令行函数用。中间踩了两个小坑:Windows 下 Node 的 spawn 启动 .cmd 文件会抛 EINVAL,加 shell: true 才行;DevKit 的 npm 包名不是想当然的 @huaweicloud/devkit,而是不带 scope 的 huaweicloud-devkit——前者在 npm 上根本不存在。

桥接跑通,40 多个工具全部列出。眼看胜利在望。

第二关:HD.9700053

调用 sandbox_connect,返回的却是一串冰冷的错误:

沙箱编排上游调用失败:POST /open-api-public/v1/devenvs/{id}/connections upstream error HD.9700053: Need to connect again.

此后是漫长的排查。先排除最容易背锅的几项:凭证没问题(资格检查 200),网络没问题(API 都能通),参数也没问题——换遍 CLI/VSCODE/WEBPTY 等 source 值,附带 force、reconnect 各种 body 组合,一律同样的错误码。带间隔的重试循环跑了 6 轮,毫无变化。

文档没有解释这个错误,我去读 DevKit 的源码——npm 缓存里就有完整实现。从 hdkitservice-api.mjs 到 hwlink-api.mjs,调用链看清了:DevKit 走 DevStation 的开放 API,用 SDK-HMAC-SHA256 签名。于是我复用它自己的签名模块写了直连脚本,绕过 DevKit 直接和 DevStation 对话。

这一查有了关键发现:GET 实例详情返回 200,实例真实存在——10 月 16 日创建的 hcdkmvabvn9e,ARM 架构 4 核 8G。控制平面完全正常,坏的是实例内部:沙箱里负责维持连接的 agent 掉线了,大概率是休眠后没能唤醒。

接下来把能想到的生命周期端点试了个遍:hdkitservice 的 release、disconnect、reconnect——全部 500;DevStation 的 DELETE 实例——业务错误 HD.97420107;stop/restart——404,压根不存在。API 层面能走的路,全部走到了头。

终局

结论很清楚:这是 API 无法触达的故障,唯一的出路是去 DevStation 的 Web 控制台手动重启或删除实例,结果人工找了半天没找到 DevStation 的人类用户入口。权衡之后我放弃这次部署:游戏在本地照常可玩,活动提交等沙箱恢复后再说。

复盘与思考

这次经历留下三点东西。

其一,排障路径值得沉淀:文档查不到时,源码就是最诚实的文档;利用 AI 从源码中就能复用它的签名和模块自建探测工具,把黑盒服务变成白盒实验。若不是读了 hwlink-api.mjs,我不会知道实例详情能单独查询,也就无法把故障定位到"实例内部掉线"这一层。

其二,控制平面正常不等于数据平面正常。实例能查到、元数据齐全、状态看起来健康,但内部 agent 已经死了。云服务的公开 API 覆盖不了所有故障场景,Web 控制台的人工操作永远是最后的兜底——也期待平台未来为休眠实例提供自动唤醒或强制重建的接口。

其三,失败也要留下资产。所有验证过走不通的路径、桥接脚本、直连脚本、提交脚本,我都留在了项目里。下次再见到 HD.9700053,五秒钟就能做出判断,不必再花一下午。

2048 里,两个相同的数字撞在一起会合成更大的数。一次失败的部署和一份完整的排查记录撞在一起,大概也算某种意义上的"合并加分"。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。