App Inventor 翻译组件报 Yandex Error 502?多半是旧组件没升级,几分钟排查完

« 返回首页

课上翻译组件报 Yandex Error 502?多半是旧版 YandexTranslate 组件没升级成新的翻译器,重新登录打开项目让它自动转换即可。

课堂上最尴尬的一幕

信息科技课上到一半,学生举手说:”老师,我的翻译 App 一直报错。”你凑过去一看,屏幕上弹着一行 “Yandex Error 502”。操作步骤都是照着你教的做的,翻译组件该连的都连了,为什么就是不通?

最近就有老师遇到一模一样的情况:学生的翻译 App 运行时报 Yandex Error 502,怀疑是不是翻译服务弃用了、是不是后台出了问题,但一时说不清。最后发现,真正的原因出在一个很隐蔽的地方——项目里用的是旧版翻译组件,从来没被升级过。

502 的真正原因:组件换代了,旧项目没跟上

事情要从一个组件改名说起。

App Inventor 早期的翻译组件叫 YandexTranslate(Yandex 翻译),后来在 2022 年的 nb189 版本中被替换成了新的 翻译器(Translator) 组件,翻译后台也换了。官方设计了对老项目的兼容机制:用旧组件的项目,重新登录打开时会自动把 YandexTranslate 转换成新的翻译器,理论上不需要手动干预。

但有三种情况会让旧组件”漏网”:

  1. 项目长期没打开过:如果一份老项目文件(.aia)一直没在 nb189 之后登录打开过,它里面留的还是旧组件。
  2. 看到报错就先怀疑服务:502 是”网关错误”类的提示,加上 Yandex 翻译服务确实换过供应商(先后用过 Yandex 和 Amazon 的翻译服务),中间切换阶段可能产生类似的旧报错信息,很容易让人误以为是”官方服务挂了”。
  3. 自己的积木逻辑有小错:这位老师最后的结论很有代表性——”重新登录后组件自动转换成了新的翻译器,就能用了。其实是我自己代码的问题,之前根本没出过什么大事。”

所以排查顺序应该是:先查组件新旧,再查网络环境,最后检查自己的积木。

照着做的排查步骤

第 1 步:看组件面板里的名字。

在项目设计页的组件列表里找翻译组件:

  • 显示为 翻译器(Translator)→ 组件是新的,继续第 3 步。
  • 显示为 YandexTranslate → 就是它了。别手动删了重加(那样积木会断开),直接进行第 2 步。

第 2 步:重新登录打开项目,让自动转换生效。

退出当前会话,重新登录你的 App Inventor 账号,打开这个旧项目。系统会提示把 YandexTranslate 转换成翻译器(或在打开时静默完成转换)。转换后检查一下原来的积木块是否都还挂在正确的位置——大多数情况下积木会原样保留,但如果个别积木断开了,按下面的写法补回去即可。

第 3 步:确认积木写法符合新组件。

翻译器组件的核心用法是这样:

when 按钮_翻译.Click() {
  翻译器1.RequestTranslation(下拉框_目标语言.Selection, 文本输入框_原文.Text)
}

when 翻译器1.GotTranslation(响应代码, 译文) {
  if 响应代码 = "200" {
    标签_译文.Text = 译文
  } else {
    标签_译文.Text = join("翻译失败,响应代码:", 响应代码)
  }
}

几个容易踩的坑:

  • 方法名是请求翻译,不是 Translate;第一个参数是目标语言(语言代码如 "en"、"ja"),第二个参数才是待翻译文本,顺序别写反。
  • 必须等获得译文事件回来再取译文。翻译是异步的,不能点完按钮立刻读结果。这个事件有两个参数:响应代码和译文——翻译器没有单独的失败事件,响应代码不是 200 就是出错了,在上面的事件里判断即可,学生屏幕上显示的就是具体原因而不是一片空白。
  • 目标语言用语言代码,可以从下拉框(Spinner)组件里选,避免学生手打拼写错误。

第 4 步:如果组件是新的还报错,查网络环境。

有一种特殊情况值得一提:有老师一开始还发现”自己电脑上能用、学生的机器上不行”。如果排除了组件版本问题,翻译 App 在部分设备上仍然报网络类错误,要考虑学校网络的访问限制——有些校园网或学校的设备管理策略会拦截部分外部服务地址。可以换一台设备、换一个网络(比如手机热点)快速验证。

给备课老师的两条预防建议

1. 用老教案前,先自己跑一遍。 如果你手里有几年前下载的 .aia 案例文件,导入后先看一眼组件面板有没有 YandexTranslate 这类旧组件。有就登录打开一次让它自动转换,再检查积木是否完好。这一步花两分钟,能省掉课堂上半小时的救火。

2. 给学生的案例模板加上错误提示。 在教学模板里就写好响应代码的判断逻辑(如上面的 if 响应代码 = "200"),让学生第一眼看到的是可读的错误信息。这也是个很好的教学点:真实的应用都要考虑”请求可能失败”,让学生从小建立这个意识。

小结

  • Yandex Error 502 十有八九是旧组件没升级:重新登录打开项目,让 YandexTranslate 自动转换成翻译器。
  • 新组件的写法:请求翻译(目标语言, 文本) 发起,获得译文(响应代码, 译文) 收结果,没有独立的失败事件,用响应代码是否为 200 判断成败。
  • 手里存的案例文件越老,上课前越值得先花几分钟自查一遍——依赖在线服务的组件(翻译、地图、机器学习)都是会随版本演进的。
文档反馈