数据库 oss_restful_api 的错误日志分析（附完整解决方案）-JavaScript中文网-JavaScript教程资源分享门户

前言

随着云计算和大数据的普及，越来越多的数据被存储在云端。OSS（Object Storage Service）是阿里云提供的对象存储服务，提供了海量、安全、低成本、高可靠的云存储服务。oss_restful_api 是基于 OSS 的 RESTful API，可以方便地实现对 OSS 存储的文件进行增删改查等操作。

然而，在使用 oss_restful_api 过程中，可能会遇到各种错误，如何快速定位和解决这些错误是前端开发人员必备的技能之一。本文将对 oss_restful_api 的错误日志分析进行详细讲解，并提供完整的解决方案，帮助读者快速解决问题。

错误日志分析

oss_restful_api 的错误日志分为两种类型：客户端错误和服务端错误。客户端错误一般是由于请求参数不合法或者网络连接异常导致的，而服务端错误则是由于服务器内部错误或者权限不足等原因导致的。我们需要针对不同类型的错误进行不同的处理。

客户端错误

客户端错误一般包括以下几种情况：

请求参数不合法
网络连接异常
身份验证失败

请求参数不合法

当我们发送一个不合法的请求时，oss_restful_api 会返回一个 HTTP 状态码为 400 的错误响应。例如，我们尝试上传一个空文件：

// javascriptcn.com 代码示例
const OSS = require('ali-oss');

const client = new OSS({
  region: 'oss-cn-hangzhou',
  accessKeyId: '<your accessKeyId>',
  accessKeySecret: '<your accessKeySecret>',
  bucket: '<your bucket name>'
});

client.put('test.txt', Buffer.from(''), {
  mime: 'text/plain'
}).then(res => {
  console.log(res);
}).catch(err => {
  console.error(err);
});

此时，我们会得到一个类似于以下的错误信息：

// javascriptcn.com 代码示例
{ Error: Request has no content.
    at Request.<anonymous> (/path/to/node_modules/ali-oss/lib/client.js:502:23)
    at Request.emit (events.js:198:13)
    at Request.EventEmitter.emit (domain.js:448:20)
    at Request.<anonymous> (/path/to/node_modules/ali-oss/node_modules/request/request.js:1083:10)
    at Request.emit (events.js:198:13)
    at Request.EventEmitter.emit (domain.js:448:20)
    at IncomingMessage.<anonymous> (/path/to/node_modules/ali-oss/node_modules/request/request.js:1004:12)
    at Object.onceWrapper (events.js:286:20)
    at IncomingMessage.emit (events.js:203:15)
    at IncomingMessage.EventEmitter.emit (domain.js:448:20)
  name: 'Error',
  message: 'Request has no content.',
  code: 'RequestHasNoContentError',
  requestId: '5F3DCD1C7E9E9D1B7E5C5D2F',
  statusCode: 400,
  level: 'error',
  time: 2020-08-21T07:54:20.000Z }

从错误信息中可以看出，我们的请求没有内容，因此 oss_restful_api 返回了一个 RequestHasNoContentError 错误。

网络连接异常

当我们的网络连接异常时，oss_restful_api 会返回一个 HTTP 状态码为 500 的错误响应。例如，我们尝试上传一个较大的文件，但是网络连接不稳定：

// javascriptcn.com 代码示例
const OSS = require('ali-oss');

const client = new OSS({
  region: 'oss-cn-hangzhou',
  accessKeyId: '<your accessKeyId>',
  accessKeySecret: '<your accessKeySecret>',
  bucket: '<your bucket name>'
});

client.put('large_file.txt', Buffer.alloc(1024 * 1024 * 10), {
  mime: 'text/plain'
}).then(res => {
  console.log(res);
}).catch(err => {
  console.error(err);
});

此时，我们会得到一个类似于以下的错误信息：

// javascriptcn.com 代码示例
{ Error: socket hang up
    at TLSSocket.onHangUp (_tls_wrap.js:1102:19)
    at TLSSocket.emit (events.js:198:13)
    at TLSSocket.EventEmitter.emit (domain.js:448:20)
    at emitNone (events.js:105:13)
    at TLSSocket.emit (events.js:197:7)
    at TLSSocket.EventEmitter.emit (domain.js:448:20)
    at endReadableNT (_stream_readable.js:1129:12)
    at process._tickCallback (internal/process/next_tick.js:63:19)
  name: 'Error',
  message: 'socket hang up',
  code: 'ECONNRESET',
  requestId: '5F3DCD1C7E9E9D1B7E5C5D2F',
  statusCode: 500,
  level: 'error',
  time: 2020-08-21T08:00:54.000Z }

从错误信息中可以看出，我们的网络连接出现了问题，因此 oss_restful_api 返回了一个 ECONNRESET 错误。

身份验证失败

当我们的身份验证失败时，oss_restful_api 会返回一个 HTTP 状态码为 403 的错误响应。例如，我们尝试使用错误的 accessKeyId 和 accessKeySecret 进行上传操作：

// javascriptcn.com 代码示例
const OSS = require('ali-oss');

const client = new OSS({
  region: 'oss-cn-hangzhou',
  accessKeyId: '<invalid accessKeyId>',
  accessKeySecret: '<invalid accessKeySecret>',
  bucket: '<your bucket name>'
});

client.put('test.txt', Buffer.from('hello world'), {
  mime: 'text/plain'
}).then(res => {
  console.log(res);
}).catch(err => {
  console.error(err);
});

此时，我们会得到一个类似于以下的错误信息：

// javascriptcn.com 代码示例
{ Error: SignatureDoesNotMatch
    at Request.<anonymous> (/path/to/node_modules/ali-oss/lib/client.js:502:23)
    at Request.emit (events.js:198:13)
    at Request.EventEmitter.emit (domain.js:448:20)
    at Request.<anonymous> (/path/to/node_modules/ali-oss/node_modules/request/request.js:1083:10)
    at Request.emit (events.js:198:13)
    at Request.EventEmitter.emit (domain.js:448:20)
    at IncomingMessage.<anonymous> (/path/to/node_modules/ali-oss/node_modules/request/request.js:1004:12)
    at Object.onceWrapper (events.js:286:20)
    at IncomingMessage.emit (events.js:203:15)
    at IncomingMessage.EventEmitter.emit (domain.js:448:20)
  name: 'Error',
  message: 'SignatureDoesNotMatch',
  code: 'SignatureDoesNotMatch',
  requestId: '5F3DCD1C7E9E9D1B7E5C5D2F',
  statusCode: 403,
  level: 'error',
  time: 2020-08-21T08:06:38.000Z }

从错误信息中可以看出，我们的身份验证失败，因此 oss_restful_api 返回了一个 SignatureDoesNotMatch 错误。

服务端错误

服务端错误一般包括以下几种情况：

服务器内部错误
权限不足

服务器内部错误

当 oss_restful_api 的服务器出现内部错误时，会返回一个 HTTP 状态码为 500 的错误响应。例如，我们尝试上传一个文件，但是服务器出现了内部错误：

// javascriptcn.com 代码示例
const OSS = require('ali-oss');

const client = new OSS({
  region: 'oss-cn-hangzhou',
  accessKeyId: '<your accessKeyId>',
  accessKeySecret: '<your accessKeySecret>',
  bucket: '<your bucket name>'
});

client.put('test.txt', Buffer.from('hello world'), {
  mime: 'text/plain',
  headers: {
    'x-oss-meta-test': 'test'
  }
}).then(res => {
  console.log(res);
}).catch(err => {
  console.error(err);
});

此时，我们会得到一个类似于以下的错误信息：

// javascriptcn.com 代码示例
{ Error: InternalError
    at Request.<anonymous> (/path/to/node_modules/ali-oss/lib/client.js:502:23)
    at Request.emit (events.js:198:13)
    at Request.EventEmitter.emit (domain.js:448:20)
    at Request.<anonymous> (/path/to/node_modules/ali-oss/node_modules/request/request.js:1083:10)
    at Request.emit (events.js:198:13)
    at Request.EventEmitter.emit (domain.js:448:20)
    at IncomingMessage.<anonymous> (/path/to/node_modules/ali-oss/node_modules/request/request.js:1004:12)
    at Object.onceWrapper (events.js:286:20)
    at IncomingMessage.emit (events.js:203:15)
    at IncomingMessage.EventEmitter.emit (domain.js:448:20)
  name: 'Error',
  message: 'InternalError',
  code: 'InternalError',
  requestId: '5F3DCD1C7E9E9D1B7E5C5D2F',
  statusCode: 500,
  level: 'error',
  time: 2020-08-21T08:11:05.000Z }

从错误信息中可以看出，oss_restful_api 的服务器出现了内部错误，因此返回了一个 InternalError 错误。

权限不足

当我们的权限不足时，oss_restful_api 会返回一个 HTTP 状态码为 403 的错误响应。例如，我们尝试在一个只读的 bucket 中进行上传操作：

// javascriptcn.com 代码示例
const OSS = require('ali-oss');

const client = new OSS({
  region: 'oss-cn-hangzhou',
  accessKeyId: '<your accessKeyId>',
  accessKeySecret: '<your accessKeySecret>',
  bucket: '<readonly bucket name>'
});

client.put('test.txt', Buffer.from('hello world'), {
  mime: 'text/plain'
}).then(res => {
  console.log(res);
}).catch(err => {
  console.error(err);
});

此时，我们会得到一个类似于以下的错误信息：

// javascriptcn.com 代码示例
{ Error: AccessDenied
    at Request.<anonymous> (/path/to/node_modules/ali-oss/lib/client.js:502:23)
    at Request.emit (events.js:198:13)
    at Request.EventEmitter.emit (domain.js:448:20)
    at Request.<anonymous> (/path/to/node_modules/ali-oss/node_modules/request/request.js:1083:10)
    at Request.emit (events.js:198:13)
    at Request.EventEmitter.emit (domain.js:448:20)
    at IncomingMessage.<anonymous> (/path/to/node_modules/ali-oss/node_modules/request/request.js:1004:12)
    at Object.onceWrapper (events.js:286:20)
    at IncomingMessage.emit (events.js:203:15)
    at IncomingMessage.EventEmitter.emit (domain.js:448:20)
  name: 'Error',
  message: 'AccessDenied',
  code: 'AccessDenied',
  requestId: '5F3DCD1C7E9E9D1B7E5C5D2F',
  statusCode: 403,
  level: 'error',
  time: 2020-08-21T08:16:36.000Z }

从错误信息中可以看出，我们的权限不足，因此 oss_restful_api 返回了一个 AccessDenied 错误。

完整解决方案

针对不同类型的错误，我们需要采取不同的解决方案：

请求参数不合法

当我们遇到请求参数不合法的错误时，需要检查我们的请求参数是否正确。例如，我们上传一个空文件时，应该检查文件内容是否为空。

// check if file content is empty
if (fileContent.length === 0) {
  console.error('File content is empty');
  return;
}

网络连接异常

当我们遇到网络连接异常的错误时，需要检查我们的网络连接是否正常。例如，我们上传一个较大的文件时，应该尝试多次上传，直到成功为止。

// javascriptcn.com 代码示例
// try upload 5 times
let retries = 5;

function uploadFile() {
  client.put('large_file.txt', Buffer.alloc(1024 * 1024 * 10), {
    mime: 'text/plain'
  }).then(res => {
    console.log(res);
  }).catch(err => {
    console.error(err);
    if (retries-- > 0) {
      console.log(`Retrying (${retries} retries left)...`);
      setTimeout(uploadFile, 1000);
    }
  });
}

uploadFile();

身份验证失败

当我们遇到身份验证失败的错误时，需要检查我们的 accessKeyId 和 accessKeySecret 是否正确。例如，我们上传一个文件时，应该检查我们的 accessKeyId 和 accessKeySecret 是否有效。

// check if accessKeyId and accessKeySecret are valid
if (accessKeyId === '<invalid accessKeyId>' || accessKeySecret === '<invalid accessKeySecret>') {
  console.error('Invalid accessKeyId or accessKeySecret');
  return;
}

服务器内部错误

当我们遇到服务器内部错误的错误时，需要联系 oss_restful_api 的技术支持，以获得更多的帮助。例如，我们上传一个文件时，应该尝试多次上传，或者等待一段时间后再次尝试。

// javascriptcn.com 代码示例
// try upload 5 times
let retries = 5;

function uploadFile() {
  client.put('test.txt', Buffer.from('hello world'), {
    mime: 'text/plain',
    headers: {
      'x-oss-meta-test': 'test'
    }
  }).then(res => {
    console.log(res);
  }).catch(err => {
    console.error(err);
    if (retries-- > 0) {
      console.log(`Retrying (${retries} retries left)...`);
      setTimeout(uploadFile, 1000);
    }
  });
}

uploadFile();

权限不足

当我们遇到权限不足的错误时，需要联系 oss_restful_api 的管理员，以获得更多的权限。例如，我们上传一个文件时，应该检查我们的 bucket 是否具有写权限。

// check if bucket has write permission
if (bucket === '<readonly bucket name>') {
  console.error('Bucket has no write permission');
  return;
}

总结

本文对 oss_restful_api 的错误日志分析进行了详细讲解，并提供了完整的解决方案，希望能够帮助读者快速解决问题。在使用 oss_restful_api 过程中，我们需要注意以下几点：

检查请求参数是否合法
检查网络连接是否正常
检查身份验证是否有效
联系技术支持或管理员以获得更多的帮助
多次尝试或等待一段时间后再次尝试

希望读者通过本文的学习，能够更好地掌握 oss_restful_api 的使用技巧，提高自身的开发能力。

来源：JavaScript中文网，转载请注明来源本文地址：https://www.javascriptcn.com/post/657be5d6d2f5e1655d698ea5