更新时间:2024-04-26 GMT+08:00

问题定位方法

开发过程中,您有任何问题可以在github上提交issue接口参考文档详细介绍了每个接口的参数和使用方法。

使用OBS BrowserJS SDK对接OBS服务可能会遇到许多问题,您可以通过下面介绍的步骤进行问题分析和定位:

  1. 确保使用的是OBS BrowserJS SDK的最新版本,您可以从这里下载最新版本;
  2. 确保使用OBS BrowserJS SDK的程序代码遵照OBS客户端通用示例编写,所有ObsClient的接口调用都通过回调函数进行了异常判断,例如上传对象的示例如下:

    // 创建ObsClient实例
    var obsClient = new ObsClient({
        // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
        // 前端本身没有process对象,可以使用webpack类打包工具定义环境变量,就可以在代码中运行了。
        // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
        access_key_id: process.env.AccessKeyID,
        secret_access_key: process.env.SecretAccessKey,
        // 这里以中国-香港为例,其他地区请按实际情况填写
        server: 'https://obs.ap-southeast-1.myhuaweicloud.com'
    });
    
    obsClient.putObject({
           Bucket : 'bucketname',
           Key : 'objectname',
           Body : 'Hello OBS'
    }, function (err, result) {
           if(err){
                  // 异常信息不为空,表明调用接口错误,常见场景是网络异常
                  console.error('Error-->' + err);
           }else{
                  // 异常信息为空,表明接口调用完成,通过SDK公共结果对象进一步判断HTTP状态码
                  if(result.CommonMsg.Status < 300){// HTTP状态码小于300,调用成功
                         if(result.InterfaceResult){
                               // 处理调用成功后业务逻辑
                               // 可选:调用成功后,记录调用成功的HTTP状态码和服务端请求ID
                               console.log('Status-->' + result.CommonMsg.Status);
                               console.log('RequestId-->' + result.CommonMsg.RequestId);
                         }
                  }else{
                         // 推荐:调用失败后,记录失败的HTTP状态码、服务端错误码、服务端请求ID等
                         console.log('Status-->' + result.CommonMsg.Status);
                         console.log('Code-->' + result.CommonMsg.Code); ;
                         console.log('RequestId-->' + result.CommonMsg.RequestId);
                  }
           }
    });

    您可以从这里查看关于SDK公共结果对象的详细说明。

  3. 当异常信息不为空时,首先排查客户端到OBS服务端的网络健康状况,如果网络良好,收集异常信息并联系OBS客户端运维团队定位异常原因;
  4. 当调用ObsClient的接口失败时,从SDK公共结果对象中获取HTTP状态码OBS服务端错误码后进行对照,排查失败原因;
  5. 如果通过步骤4未能排查到异常原因,可从SDK公共结果对象中获取OBS服务端请求ID后联系OBS服务端运维团队定位失败原因;
  6. 如果无法从SDK公共结果对象中获取OBS服务端请求ID,请联系OBS客户端运维团队定位失败原因。