2048 与一个顽固的错误码:我的华为云沙箱部署复盘
缘起
今天去华为开发者中心领了个活:写一个 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 里,两个相同的数字撞在一起会合成更大的数。一次失败的部署和一份完整的排查记录撞在一起,大概也算某种意义上的"合并加分"。
- 点赞
- 收藏
- 关注作者
评论(0)