跳到主要内容

通用报错码

本文档是云函数报错码的唯一数据源：定义统一错误响应格式、报错码规则（RH + 5 位数字）及报错码对照表。各模块 API 文档的「错误码」区块须引用本文档，仅补充模块特有错误；写作格式与结构由 API 文档规范 规定。

1. 错误响应格式​

业务接口失败时，统一返回形如：

{
  "success": false,
  "code": "RH00001",
  "message": "错误描述或提示文案",
  "data": null
}
字段类型说明
successBoolean固定为 false
codeString统一报错码，格式 RH + 5 位数字（如 RH00001），供前端分支、埋点与文档对照
messageString给用户或日志看的错误描述，中文为主
dataAny失败时一般为 null 或省略

与 README 2.2 通用约定 一致：出参统一为 { success, data?, message? }，失败时 success: false 且必有 message；code 为本次约定的报错码字符串，与下表一一对应。

2. 报错码规则​

  • 格式：RH + 5 位数字，例如 RH00001、RH00203。
  • 分段约定（便于扩展与归类）：
区间分类说明
RH00000～RH00099通用调用结果、鉴权、参数、权限、资源不存在、系统错误等（RH00000 表示调用成功）
RH00100～RH00199用户/账号注册、资料、地址、钱包、实名、黑名单、冻结等
RH00200～RH00299订单下单、取消、确认取件/归还、验收、拒单、取件时间等
RH00300～RH00399资产物品 CRUD、上下架、审核、配额等
RH00400～RH00499支付/钱包支付、充值、提现、退款、余额不足等
RH00500～RH00599经验/信用/违约/保险经验、星级、申诉、违约记录、理赔等
RH00600～RH00699消息/评论/推荐/帮助站内信、聊天、评价、推荐、FAQ 等
RH00700～RH00799物流/管理/其他顺丰、定时任务、管理员、配置等

新增报错时在对应区间内取未占用的最小编号，并在本文档对照表中补充一行。

3. 报错码对照表​

3.1 通用（RH00000～RH00099）​

通用错误码适用于所有云函数，表示接入与鉴权、参数、权限、资源或系统层面的问题。表格格式参考顺丰开放平台：标识 | 说明 | 解决方法。

标识说明解决方法
RH00000调用成功；注意：仅表示云函数入口调用成功，具体业务结果需看 success 与 data表示接口调用正常，根据 success 判断业务是否成功
RH00001用户身份验证失败（未登录或登录态失效，无法获取 OPENID）请做以下几点检查：1、是否已调用 wx.cloud.callFunction 前完成 CloudBase 登录；2、登录态是否过期，引导用户重新登录；3、若为测试环境，确认传入的 OPENID 或鉴权参数正确
RH00002必传参数不可为空或参数无效请做以下几点检查：1、接口文档中必传字段（如 action、data 内字段）是否均已填写；2、参数类型与格式是否符合文档（如 orderId 为字符串）；3、event.data 是否为合法 JSON、是否存在多余空格或编码问题；4、云函数入参为 { action, data? }，请确认结构正确
RH00003无权限操作或访问该资源（非资源归属方且非管理员）可能存在的原因：1、当前用户并非订单/物品/争议的关联方，请确认身份与业务角色；2、该 action 需管理员权限，请使用管理员账号或联系运维；3、资源已归属他人或状态不允许当前角色操作，请核对资源 ID 与状态
RH00004需要管理员权限该 action 仅管理员可调用。请使用管理员账号重试，或联系运维配置权限；若为前端直调，请勿暴露管理员专用接口给普通用户
RH00005用户不存在根据 OPENID 或传入的 userId 未查到对应用户。请确认：1、用户是否已完成注册；2、userId/OPENID 是否传错或已失效；3、是否使用了错误环境（测试/正式）的数据
RH00006订单或资源不存在指定 ID 对应的订单或资源在数据库中不存在或已删除。请检查：1、订单号/资源 ID 是否正确；2、是否误用其他环境的 ID；3、资源是否已被下架或物理删除
RH00007订单 ID 无效或未传未传 orderId 或格式不符合约定。请传入有效的订单 ID（字符串），且为当前环境下的有效单号
RH00008请先完成实名认证（业务要求实名后才可继续，如下单、确认收货、大额提现）引导用户完成实名认证后重试；前端可根据 code: 'NEED_VERIFICATION' 跳转至实名认证页，完成后再执行原操作
RH00009用户已在黑名单当前用户已被加入黑名单，无法执行部分或全部操作。请联系客服或管理员处理；前端可提示「账号异常，请联系客服」
RH00010账户或资源已冻结当前账户或关联资源（如物品）已被冻结，无法继续操作。请联系客服或管理员解冻；前端可提示「账号/资源已冻结，请联系客服」
RH00011服务繁忙或系统错误云函数或下游服务异常、超时、依赖失败等。请稍后重试；若持续出现，请排查：1、云函数日志与错误堆栈；2、数据库/存储/第三方接口可用性；3、必要时报障运维处理
RH00012未知错误（兜底返回）未归类的异常，实际原因以服务端日志为准。请查看云函数运行日志与 message 详情定位原因；建议在代码中为未捕获异常统一映射为 RH00011 或 RH00012 并打点上报

3.2 用户/账号（RH00100～RH00199）​

报错码典型 message / 描述解决方案
RH00100商家信息不存在检查商家/用户数据是否完整
RH00101当前地区不支持快递运输更换地址或配送方式
RH00102单笔提现 2000 元及以上需完成实名认证 / 需完善实名信息完成实名认证后再提现

3.3 订单（RH00200～RH00299）​

报错码典型 message / 描述解决方案
RH00200物品不可租该物品已下架或不可租，请选择其他物品
RH00201您已有一个未完成的订单，请先完成或取消该订单后再下单完成或取消当前未完成订单后再下单
RH00202您的信用等级不足，无法租赁高价值物品（>5000元）提升信用等级或选择其他物品
RH00203已支付的订单请等待商家确认，或联系商家取消等待商家处理或联系商家取消
RH00204订单已取消该订单已取消，无法继续操作
RH00205订单已完成，无法取消已完成订单不可取消
RH00206商品尚未发货，无法确认收货等待商家发货后再确认收货
RH00207订单状态异常 / 订单状态异常，无法验收检查订单当前状态，必要时联系客服
RH00208提前退租订单需先确认归还先确认归还再申请验收
RH00209物品损坏需提供证据（视频或图片）上传损坏证据后再提交验收
RH00210只有待确认的订单可以拒绝仅待确认状态可拒单
RH00211订单状态异常，无法设置取件时间确认订单为待确认等可设置状态
RH00212请选择上门取件时间选择取件时间后重试
RH00213取件时间必须晚于当前时间选择未来的取件时间
RH00214物流订单已创建，无法修改取件时间取件时间已锁定
RH00215设置取件时间成功，但创建物流订单失败稍后重试或联系客服
RH00216配送订单请先选择上门取件时间先设置取件时间再确认发货
RH00217强制取消订单失败查看 message 详情，稍后重试或联系管理员
RH00218需先预付运费（商家破土单去程+回程）根据 data.amount 预付运费后重试

争议相关（RH00220～RH00241）​

报错码典型 message / 描述解决方案
RH00220当前订单状态不允许发起争议仅待收货(shipped)、租赁中(ongoing)、待归还(returning)状态可发起
RH00221该订单已有未关闭的争议，请在现有争议中补充前往已有争议补充证据或沟通
RH00240仅租户可发起订单相关争议，商家不可在订单中报告问题订单相关争议由租户在订单页「报告问题」发起，商家可参与协商/调解
RH00222争议类型与大类不匹配检查 type 是否属于所选 category
RH00223争议不存在检查 disputeId 是否正确
RH00224无权操作此争议仅争议关联方可操作
RH00225当前争议状态不允许此操作检查争议当前状态，参考状态流转规则
RH00226证据数量超过限制（最多9项）删除部分证据后再上传
RH00227问题描述至少10个字补充描述内容
RH00228争议范围与大类不匹配检查 scope 与 category 的对应关系
RH00229用户之间的争议必须关联订单scope=user_to_user 时须传 orderId
RH00230和解方案不存在检查 proposalId 是否正确
RH00231不能回应自己提出的方案等待对方回应
RH00232争议金额超过调解限额（≤10,000元）金额>10,000元请直接走仲裁/诉讼
RH00233已超过调解申请时限（争议发生30日内）请走仲裁/诉讼途径
RH00234请先完成协商阶段后再申请调解至少尝试协商后方可申请调解
RH00235电子协议不存在检查 agreementId
RH00236您已确认此协议无需重复确认
RH00237执行金额超过平台限额（≤50,000元）超额部分请申请法院强制执行
RH00238（已废弃）原「已超过答辩期限」平台已取消答辩流程；新实现不应再返回此码
RH00239和解方案已过期请提出新的和解方案
RH00240仅租户可发起订单相关争议商家不可从订单发起争议
RH00241申请调解前须完成本方证据（≥1 张图片 + 辩解词达到最短字数）补充图片与辩解词后重试
RH00257争议内嵌发消息接口已停用在小程序争议详情点击「与对方沟通」或「与平台调解员沟通」进入 message 聊天；勿再调用 dispute.sendDisputeMessage / sendMediationThreadMessage

争议管理端（RH00250～RH00259）​

报错码典型 message / 描述解决方案
RH00250无效的管理操作action 参数不正确
RH00251调解申请已被受理勿重复受理
RH00252当前不在调解阶段检查争议状态是否为 mediating 或 mediation_accepted
RH00253调解方案内容不完整resolution 和 terms 必填
RH00254紧急措施执行失败检查目标用户账户状态
RH00255消息内容超过500字限制精简内容
RH00256协议条款不得超过10条精简条款

3.4 资产（RH00300～RH00399）​

报错码典型 message / 描述解决方案
RH00300物品已下架 / 不可用选择其他在架物品
RH00301发布数量已达上限下架或删除部分物品后再发布
RH00302仅创建者可编辑/删除使用物品所属账号操作
RH00303需管理员权限（下架/审核等）使用管理员账号操作
RH00304物品一级/二级分类组合无效按 shared/contracts/asset.js 选择合法 categoryL1Id + categoryL2Id
RH00305成新度 conditionGrade 无效使用契约定义的六种成新度枚举值
RH00310智能识别描述文本为空输入非空描述后再调用 aiParseItem

（更多资产相关错误可在本区间内按需追加。）

3.5 支付/钱包（RH00400～RH00499）​

报错码典型 message / 描述解决方案
RH00400订单已超时，请重新下单重新发起下单与支付
RH00401提现金额必须大于 0 / 提现金额不能低于 0.01 元输入有效提现金额
RH00402余额不足充值或降低提现/支付金额
RH00403钱包余额为 0，请更换支付方式（WALLET_ZERO）使用微信支付等其他方式
RH00404钱包余额不足，当前余额 ¥x.xx充值或选择混合支付
RH00405抵扣金额不能超过订单总额调整抵扣金额
RH00406充值金额需在 0.01～10000 元之间输入合规充值金额
RH00407支付配置不完整，请配置 notifyUrl联系管理员配置支付回调
RH00408微信支付金额不能小于 0.01 元，请使用钱包全额支付改用钱包支付或提高金额
RH00409转账受理中，请稍后重试（请勿更换金额再次发起）等待前一笔提现结果
RH00410发起转账失败，请稍后重试稍后重试或联系客服
RH00411商家转账未配置，请联系管理员配置 transferNotifyUrl、transferSceneId联系管理员配置
RH00412记录不存在或已处理 / 充值记录不存在确认记录 ID 或订单状态
RH00413创建支付订单失败查看 message，稍后重试

3.6 经验/信用/违约/保险（RH00500～RH00599）​

报错码典型 message / 描述解决方案
RH00500经验值不足 / 信用不足完成订单或任务提升经验与信用
RH00501申诉已处理 / 申诉不存在确认申诉 ID 与状态
RH00502理赔单不存在 / 理赔已关闭确认理赔 ID 与状态

（更多经验、违约、保险相关错误可在本区间内按需追加。）

3.7 消息/评论/推荐/帮助（RH00600～RH00699）​

报错码典型 message / 描述解决方案
RH00600会话不存在 / 对方用户不存在检查会话 ID 或对方 userId
RH00601已评价过该订单每个订单仅可评价一次
RH00602推荐码无效 / 已绑定推荐人检查推荐码或推荐关系状态
RH00603聊天场景参数无效或与已有会话冲突检查 scene / disputeId / threadKey 与 createOrGetChat 契约
RH00604无权访问该场景会话确认当前用户为租赁对方或争议参与方 / 调解线程当事人
RH00605调解线程无效或当前争议状态不允许核对 DISPUTE_MEDIATION_THREAD_KEY 与争议状态（见争议 API）
RH00606图片消息参数无效（如缺少 fileID）先 wx.cloud.uploadFile 再传 imageFileIds
RH00607不支持的消息类型使用契约允许的 messageType

（更多消息、评论、推荐、帮助相关错误可在本区间内按需追加。）

3.8 物流/管理/其他（RH00700～RH00799）​

报错码典型 message / 描述解决方案
RH00700业务异常或其它（物流失败、数据校验不通过、管理端操作失败等；云函数可传自定义 message，如「发现 N 个订单状态无效」）查看返回的 message，稍后重试或联系客服/管理员
RH00701定时任务执行失败查看服务端日志，由运维处理
RH00702配置项不存在 / 配置未初始化执行初始化或联系管理员

（更多物流、管理员、配置相关错误可在本区间内按需追加。）

3.9 按报错码排序速查​

报错码说明（简要）
RH00000调用成功（业务结果看 success/data）
RH00001用户身份验证失败
RH00002参数错误 / 参数无效 / param-error
RH00003无权限 / 无权操作此订单
RH00004需要管理员权限
RH00005用户不存在
RH00006订单不存在 / 资源不存在
RH00007订单ID无效 / 订单ID不能为空
RH00008请先完成实名认证（NEED_VERIFICATION）
RH00009用户已在黑名单（BLACKLISTED）
RH00010账户或资源已冻结（FROZEN）
RH00011服务繁忙 / 系统错误
RH00012未知错误（unknown）
RH00100商家信息不存在
RH00101当前地区不支持快递运输
RH00102大额提现需实名认证
RH00200物品不可租
RH00201已有未完成订单，请先完成或取消
RH00202信用等级不足无法租赁高价值物品
RH00203已支付订单请等待商家确认或联系取消
RH00204订单已取消
RH00205订单已完成无法取消
RH00206商品尚未发货无法确认收货
RH00207订单状态异常
RH00208提前退租需先确认归还
RH00209物品损坏需提供证据
RH00210只有待确认订单可拒绝
RH00211订单状态异常无法设置取件时间
RH00212请选择上门取件时间
RH00213取件时间必须晚于当前时间
RH00214物流订单已创建无法修改取件时间
RH00215创建物流订单失败
RH00216配送订单请先选择取件时间
RH00217强制取消订单失败
RH00218需先预付运费（商家破土单）
RH00220当前订单状态不允许发起争议
RH00221该订单已有未关闭的争议
RH00222争议类型与大类不匹配
RH00223争议不存在
RH00224无权操作此争议
RH00225当前争议状态不允许此操作
RH00226证据数量超过限制
RH00227问题描述至少10个字
RH00228争议范围与大类不匹配
RH00229用户之间争议必须关联订单
RH00230和解方案不存在
RH00231不能回应自己提出的方案
RH00232争议金额超过调解限额
RH00233已超过调解申请时限
RH00234请先完成协商阶段
RH00235电子协议不存在
RH00236已确认此协议
RH00237执行金额超过平台限额
RH00238（已废弃）原答辩期限
RH00239和解方案已过期
RH00240仅租户可发起订单相关争议
RH00241调解申请证据不完整
RH00257争议发消息已迁入站内聊天
RH00250无效的管理操作（管理端）
RH00251调解申请已被受理（管理端）
RH00252当前不在调解阶段（管理端）
RH00253调解方案内容不完整（管理端）
RH00254紧急措施执行失败（管理端）
RH00255消息内容超过500字限制（管理端）
RH00256协议条款不得超过10条（管理端）
RH00300物品已下架/不可用
RH00301发布数量已达上限
RH00302仅创建者可操作
RH00303需管理员权限
RH00304物品分类组合无效
RH00305成新度枚举无效
RH00310智能识别文本为空
RH00400订单已超时请重新下单
RH00401提现金额不合法
RH00402余额不足
RH00403钱包余额为 0 请换支付方式
RH00404钱包余额不足
RH00405抵扣金额不能超过订单总额
RH00406充值金额超出范围
RH00407支付配置不完整
RH00408微信支付金额不能小于 0.01 元
RH00409转账受理中请勿重复发起
RH00410发起转账失败
RH00411商家转账未配置
RH00412记录不存在或已处理
RH00413创建支付订单失败
RH00500经验值/信用不足
RH00501申诉已处理/不存在
RH00502理赔单不存在/已关闭
RH00600会话/对方用户不存在
RH00601已评价过该订单
RH00602推荐码无效/已绑定
RH00603聊天场景参数无效或会话冲突
RH00604无权访问该场景会话
RH00605调解线程无效或争议状态不允许
RH00606图片消息参数无效
RH00607不支持的消息类型
RH00700业务异常或其它（可带自定义 message）
RH00701定时任务执行失败
RH00702配置项不存在/未初始化

4. 使用说明​

  • 云函数实现：返回失败时须设置 code: 'RHxxxxx'（与上表一致），便于前端与埋点统一处理；message 可为默认文案或 fail(code, messageOverride) 传入的自定义文案。
  • 与《00-API 文档规范》的关系：规范规定各模块 API 文档的写作格式与结构；其中「错误码」区块以本文档为唯一数据源，模块文档只引用本文档并仅补充模块特有错误。新增报错时先在本文档对应区间分配编号并更新对照表，再在模块文档中引用或列出。
  • 各模块 API 文档：在「错误码 (Error Codes)」区块写「见 通用报错码」；模块独有错误在对应区间内分配新编号并在本文档与模块文档中补充。
  • 前端：可根据 code 做分支（如 RH00008 跳转实名、RH00402 提示充值）；无 code 时仅用 message 展示即可。
  • 新增报错：在对应分段取未占用的最小编号，在「报错码对照表」中增加一行，并在代码（各云函数下的 errorCodes.js）中统一使用该 code 与对应 message。