业务容灾方案（Web 及 APP）
更新时间：2026-07-07 15:59:32
业务容灾方案（Web 及 APP）
业务客户端（前端）容灾
- 定义错误处理函数。
// 错误处理函数作用：在脚本加载或初始化错误时，保障事件流程正常
// 定义验证码js加载错误处理函数
function loadErrorCallback() {
var appid = '您的CaptchaAppId';
// 生成容灾票据或自行做其它处理
var ticket = 'trerror_1001_' + appid + '_' + Math.floor(new Date().getTime() / 1000);
callback({
ret: 0,
randstr: '@'+ Math.random().toString(36).substr(2),
ticket: ticket,
errorCode: 1001,
errorMessage: 'jsload_error'
});
}- 验证码返回错误时，调用错误处理函数。
try {
// 生成一个验证码对象
var captcha = new TencentCaptcha('您的验证码CaptchaAppId', callback, {});
// 调用方法，显示验证码
captcha.show();
} catch (error) {
// 加载异常，调用验证码js加载错误处理函数
loadErrorCallback();
}- 回调函数根据 ticket 和 errorCode （而非 ret）的情况做处理。
function callback(res) {
// res（用户主动关闭验证码）= {ret: 2, ticket: null}
// res（验证成功） = {ret: 0, ticket: "String", randstr: "String"}
// res（请求验证码发生错误，验证码自动返回trerror_前缀的容灾票据） = {ret: 0, ticket: "String", randstr: "String", errorCode: Number, errorMessage: "String"}
if (res.ticket){
//根据errorCode情况做特殊处理
if(res.errorCode === xxxxx){
//自定义容灾逻辑（例如跳过这次验证）
}
}
}说明： ticket：验证成功的票据，当且仅当 ret = 0 时 ticket 有值。 errorCode：错误 code ，详情请参见 回调函数 errorCode 说明。
业务服务端（后端）容灾
当请求验证码票据校验接口发生异常时，客户服务端需做出相应的业务异常处理（例如跳过这次验证），保证不会因为接口返回结构异常，请求超时或服务未响应而阻碍业务流程。如下为几种异常返回的情况，需要客户侧进行容灾。
- 请求超时或服务未响应。
- 返回异常，Code为InternalError，接口返回举例如下：
{
"Response": {
"Error": {
"Code": "InternalError",
"Message": "An internal error has occurred. Retry your request, but if the problem persists, contact us."
},
"RequestId": "xxxxxxxxxxx"
}
}- 服务内部错误，CaptchaCode 为26，接口返回举例如下：
{
"Response": {
"CaptchaCode": 26,
"CaptchaMsg": "system busy 详情请参考：腾讯云-天御验证码-产品文档，搜索关键字“DescribeCaptchaResult”，查看输出参数中CaptchaCode字段的具体描述",
"EvilLevel": 0,
"GetCaptchaTime": 0,
"RequestId": "xxxxxxxxxxx"
},
"retcode": 0,
"retmsg": "ok"
}这篇文档对您有帮助吗？
