AI Agent 全链路交付实录:从 WAF 拦截到 OAuth 超时,10 个真实踩坑与解法

举报
yd_259466337 发表于 2026/11/03 15:07:20 2026/11/03
【摘要】 AI Agent 全链路交付实录:从 WAF 拦截到 OAuth 超时,10 个真实踩坑与解法承接上一篇《一次对话,从零到公网上线》。这次不谈成功,专谈失败——AI Agent(华为云 CodeArts)帮我完成 2048 游戏"生成→部署→提交→上架"全链路的过程中,实际踩了 10 个坑。每个坑都有真实错误码、排查过程和解法,照方抓药即可。 一、沙箱部署类(3 个坑) 坑 1:节点池满载...

AI Agent 全链路交付实录:从 WAF 拦截到 OAuth 超时,10 个真实踩坑与解法

承接上一篇《一次对话,从零到公网上线》。这次不谈成功,专谈失败——AI Agent(华为云 CodeArts)帮我完成 2048 游戏"生成→部署→提交→上架"全链路的过程中,实际踩了 10 个坑。每个坑都有真实错误码、排查过程和解法,照方抓药即可。

一、沙箱部署类(3 个坑)

坑 1:节点池满载,HD.99003001

POST /devenvs/{id}/start 持续返回 No available node pool。这不是配置错误,是排队——但 Agent 没干等,起了 15 秒间隔的重试循环,失败后自动 close 重置,排队半小时自动拿到连接。

解法:15 秒间隔循环重试即可,无需人工干预。

坑 2:实例卡死,HD.98330021

排队中途某次 start 被受理后实例卡在中间态,之后所有重试都返回 Dev environment is not closed and cannot be started。

解法:对 devenvs/{id}/close 发 POST {"source":"CLI"} 强制重置(幂等),再重连。Agent 每轮重试前自动执行这一步,循环自愈。

坑 3:region 不匹配,“作品链接无效”

向活动提交 ECS 部署成果时反复报"作品链接无效",毫无线索。排查后发现:ECS 实例实际在 cn-east-3,而提交头 X-HW-REGION 传的是 cn-north-4。

解法:先 hcloud ECS NovaListServers --cli-region=<r> 遍历各 region 定位实例真实位置,再用对应 region 的 Project ID(IAM KeystoneListProjects 查)重提,一次通过。报错信息不提示双方 region 值,这个坑极容易白耗一小时——已向云声提交改进建议。

二、平台 API 类(4 个坑)

坑 4:提交接口被 WAF 拦截,HTTP 405

用 CLI 提交小红书 SkillHub 作品,连续报"提交失败: 响应解析失败"。CLI 吞掉了真实状态码。手动复现后发现:服务端返回的是阿里云网关的 HTML 405 错误页——请求体内容触发了 WAF 规则。

解法:二分定位触发字段(空 body 200 / 补一个字段 405),确认是文章正文里的 shell 命令行样式内容(curl ... && <nginx> ... && | head -1)触发。改写为自然语言描述后 200 通过。

教训:网关 405 + HTML 响应 = 内容被 WAF 拦,不是方法错误。命令行样例正文是重灾区。

坑 5:YAML 多行字段解析缺陷

SKILL.md 的 description: | 多行语法,发布工具解析后只剩一个 | 字符。

解法:发布会话内用 edit 指令覆盖 description(每次新会话都要重新 edit,根因在 CLI 的 YAML 解析,已提建议)。

坑 6:名称长度限制,4004

作品/技能名 game2048-huaweicloud-deploy(26 字符)触发"名称长度不符合要求"。

解法:中文名控制在 10 字符左右(改为《2048游戏云上一键部署》)。中文场景下别用长英文连字符名。

坑 7:文档与实现不一致,PROJECT_ID_MISSING

提交技能文档写明 PROJECT_ID 请求头"仅 ECS 步骤携带",实测 beginner(沙箱步骤)服务端同样强制要求。按文档实现直接 400。

解法:两步都带上 X-HW-PROJECT-ID(用 IAM KeystoneListProjects 查对应 region 的项目 ID)。文档滞后于服务端,以实测为准。

三、工具链与流程类(3 个坑)

坑 8:KooCLI 自动安装静默失败

npx huaweicloud-devkit install-hcloud 在 Node v22.11 报 Cannot find module 'node:sqlite'——该版本 node:sqlite 需要 --experimental-sqlite 标志,脚本未处理,且失败藏在后台日志里不易察觉。

解法:NODE_OPTIONS="--experimental-sqlite" npx huaweicloud-devkit install-hcloud,或直接下载官方 CLI 包。

坑 9:OAuth 授权会话超时的连环坑

GitCode 授权流程三个小坑叠加:① 会话 300 秒超时,用户离开几分钟就要重来;② 超时后重新生成的新会话 userCode 可能与旧的相同,极易让用户误以为还是旧会话;③ 终端 ASCII 二维码部分设备无法识别。

解法:把授权链接生成高清 PNG 图片挂到公网(如已部署的站点目录),用户手机浏览器打开后用 App 扫码;每轮确认 userCode 与 state 是否更新;提前告诉用户"必须在 5 分钟内完成授权+点击确认按钮"。

坑 10:环境重置导致本地状态丢失

长会话中途环境疑似重置:KooCLI 二进制消失(前后装了 3 次)、GitCode token 失效(重新授权 2 次)、已装技能目录被清空、/tmp 标记文件消失。

解法:把重装/重授权动作脚本化(如独立的 restart-publish.sh),用脚本文件而非内联命令执行——顺带避开另一个经典坑:pkill -f <模式> 时模式串出现在自己的命令行里导致自杀。

四、方法论:让 Agent 自己排障的三个技巧

  1. 让 Agent 读源码。CLI 报"响应解析失败"不透出状态码时,直接让它 grep 源码定位抛错点,再用 curl 复现真实响应——10 分钟定位到 405 + HTML 错误页。
  2. 二分定位敏感内容。WAF 拦截类问题,把 payload 按字段/行拆成变体逐个试探,3 轮内锁定触发内容。
  3. 后台脚本 + 状态标记文件。长等待(沙箱排队)用后台循环写状态文件,主流程轮询标记文件,避免阻塞与循环检测冲突。

五、成绩单

一天会话的最终产出:闯关活动 3000 分、作品展览馆发布(200 成长积分)、GitCode 仓库、小红书 SkillHub 参赛(审核中)、华为云技能市场上架、GitCode Issue 提交、14 条云声产品建议。所有踩坑均已沉淀为技能内的排错锦囊。

下一篇预告:Agent 交互体验的三个产品级改进方向(非中断引导、循环检测豁免、环境状态持久)。


文中错误码、HTTP 状态码与解法均为真实会话实录。涉及的两个产品缺陷(YAML 解析、报错透出)已通过官方渠道反馈。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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