错误码
插件在唤起失败或检测异常时，通过 Storage 出参 errorCode 返回以下错误码。
唤起 / 鉴权错误
| 错误码 | 含义 | 处理建议 |
|---|
1001 | 签名验证失败 | 检查 sign 算法：管道符格式、字段顺序（appKey | thirdUserId | timestamp | nonce）、appSecret 是否正确 |
1002 | timestamp 超时（±5 分钟） | 检查服务端时钟是否同步（NTP）；确认 timestamp 为 10 位 Unix 秒而非毫秒 |
1003 | nonce 重复 | 每次唤起必须重新生成随机 nonce，不可复用 |
1004 | appKey 不存在或已禁用 | 联系晓葆商务确认凭证是否有效，区分沙箱与生产 |
档案 / 设备错误
| 错误码 | 含义 | 处理建议 |
|---|
2001 | userProfile 解密失败 | 检查加密算法：key = SHA256(appSecret) binary，AES-256-CBC，base64(iv + ciphertext) |
2002 | userProfile 格式错误 | 加密前明文应为合法 JSON 字符串，UTF-8 编码 |
2003 | 体脂档案缺失必填字段 | BCA（BODY_COMPOSITION_ANALYSIS）场景，userProfile 中补全 height / gender / birth_date |
4003 | deviceKey 不在应用白名单 | 联系晓葆商务开通对应设备权限；区分沙箱与生产凭证 |
服务端错误
| 错误码 | 含义 | 处理建议 |
|---|
5001 | 晓葆服务端内部异常 | 稍后重试；如持续发生请联系晓葆技术支持并提供 measureId |
5002 | 算法服务超时（ECG / BCA） | 异步算法超时，Webhook 将不会推送；如需重新获取结果请联系晓葆技术支持 |
遇到错误码后可在晓葆开发者门户 → 日志查看请求详情，或联系晓葆技术支持时提供measureId（即插件出参 measureId）以便快速定位。