OpenHarmony验证码为何报错

在 OpenHarmony 开发中出现“验证码报错”通常不是系统本身的问题，而是业务实现或环境配置导致的。下面按常见原因分类说明，你可以对照排查：

一、常见报错原因

1️⃣ 网络请求失败（最常见）

验证码一般依赖后端接口（短信 / 邮箱 / 图形验证码）

• 未配置网络权限
• 请求 URL 错误
• 模拟器 / 真机无网络

✅ 检查：

// module.json5
"requestPermissions": [
  {
    "name": "ohos.permission.INTERNET"
  }
]

2️⃣ 接口返回数据结构不匹配

后端返回：

{
  "code": 0,
  "data": "1234"
}

但前端解析成：

res.result.code

导致 undefined 或报错

✅ 建议统一封装响应判断：

if (res.code !== 0) {
  promptAction.showToast({ message: res.msg })
}

3️⃣ 图形验证码（Canvas）绘制异常

OpenHarmony 使用 @ohos.graphics.canvas 常见错误：

• Canvas 未初始化完成就绘制
• 尺寸为 0

✅ 正确示例：

Canvas(this.context)
  .onReady(() => {
    this.drawCode()
  })

4️⃣ 倒计时逻辑错误

使用 setInterval 但页面销毁未清除

• 报错：Cannot read property of undefined
• 多次点击造成重复请求

✅ 建议：

let timer: number = -1

页面销毁：

aboutToDisappear() {
  if (timer !== -1) clearInterval(timer)
}

5️⃣ ArkTS 类型或语法错误

例如：

let code: string = await getCode() // 实际返回 number

✅ 打开 DevEco 的 Problems / Log

6️⃣ 后端限流 / 验证失败

• 短时间内重复获取验证码
• 手机号 / 邮箱格式错误
• token 失效

✅ 后端返回示例：

{
  "code": 429,
  "msg": "请求过于频繁"
}

二、快速自查清单 ✅

• [ ] 是否添加 INTERNET 权限
• [ ] 接口地址是否正确
• [ ] 返回数据是否按字段解析
• [ ] Canvas 是否 onReady 后绘制
• [ ] 倒计时是否清理
• [ ] 是否真机 / 模拟器网络正常

三、如果你愿意，我可以更精确帮你

你可以补充：

1. 报错信息（完整日志）
2. 验证码类型（短信 / 图形 / 邮箱）
3. API 9 / 10 / 11？
4. ArkTS 还是 JS？

我可以直接帮你定位并给出修改代码。