Echo 框架: RPC 错误码设计

原创

尹东勋

修改于 2021-12-13 00:27:00

8470

修改于 2021-12-13 00:27:00

文章被收录于专栏：开源 & 技术分享

介绍

本文通过一个完整的例子，介绍如何在 Echo 框架下设计合理的 API 错误码。

我们将会使用 rk-boot 来启动 Echo 基于框架的微服务。

请访问如下地址获取完整教程：

https://rkdocs.netlify.app/cn

考虑范围

一个合理的 RPC 错误，需要考虑如下几个方面。

包含错误码，错误信息
错误信息可扩展
考虑可读性
可解析性，即，用户可通过代码解析错误码，并采取有效行为
避免内部错误益处，例如，Nil point error

错误码结构

{
    "error":{
        "code":500,
        "status":"Internal Server Error",
        "message":"Panic manually!",
        "details":[]
    }
}

安装

go get github.com/rookie-ninja/rk-boot
go get github.com/rookie-ninja/rk-echo

快速开始

通过 rk-boot ，用户可以轻松搭建 Echo 框架微服务，rk-boot 集成了 Panic 捕捉以及标准错误类型。

完整例子

1.创建 boot.yaml

boot.yaml 文件描述了 Echo 框架启动的原信息，rk-boot 通过读取 boot.yaml 来启动 Echo。

---
echo:
  - name: greeter
    port: 8080
    enabled: true

2.创建 main.go

让 /v1/greeter 返回一个错误。

// Copyright (c) 2021 rookie-ninja
//
// Use of this source code is governed by an Apache-style
// license that can be found in the LICENSE file.
package main

import (
	"context"
	"github.com/labstack/echo/v4"
	"github.com/rookie-ninja/rk-boot"
	"github.com/rookie-ninja/rk-echo/boot"
	"github.com/rookie-ninja/rk-common/error"
	"net/http"
)

// @title RK Swagger for Echo
// @version 1.0
// @description This is a greeter service with rk-boot.
func main() {
	// Create a new boot instance.
	boot := rkboot.NewBoot()

	// Register handler
	boot.GetEntry("greeter").(*rkecho.EchoEntry).Echo.GET("/v1/greeter", Greeter)

	// Bootstrap
	boot.Bootstrap(context.Background())

	// Wait for shutdown sig
	boot.WaitForShutdownSig(context.Background())
}

// @Summary Greeter service
// @Id 1
// @version 1.0
// @produce application/json
// @Param name query string true "Input name"
// @Success 200 {object} GreeterResponse
// @Router /v1/greeter [get]
func Greeter(ctx echo.Context) error {
	err := rkerror.New(
		rkerror.WithHttpCode(http.StatusAlreadyReported),
		rkerror.WithMessage("Trigger manually!"),
		rkerror.WithDetails("This is detail.", false, -1, 0.1))

	return ctx.JSON(http.StatusAlreadyReported, err)
}

3.启动 main.go

$ go run main.go

4.验证

$ curl "localhost:8080/v1/greeter?name=rk-dev"
{
    "error":{
        "code":208,
        "status":"Already Reported",
        "message":"Trigger manually!",
        "details":[
            "This is detail.",
            false,
            -1,
            0.1
        ]
    }
}

捕获 Panic（系统崩溃）

我们还是以 demo 代码为例子。

在 RPC 实现中，我们试着让系统崩溃，看看 rk-boot 会如何自动捕获，并且返回何种信息给用户。

1.修改 main.go

// Copyright (c) 2021 rookie-ninja
//
// Use of this source code is governed by an Apache-style
// license that can be found in the LICENSE file.
package main

import (
	"context"
	"github.com/labstack/echo/v4"
	"github.com/rookie-ninja/rk-boot"
	"github.com/rookie-ninja/rk-echo/boot"
)

// @title RK Swagger for Echo
// @version 1.0
// @description This is a greeter service with rk-boot.
func main() {
	// Create a new boot instance.
	boot := rkboot.NewBoot()

	// Register handler
	boot.GetEntry("greeter").(*rkecho.EchoEntry).Echo.GET("/v1/greeter", Greeter)

	// Bootstrap
	boot.Bootstrap(context.Background())

	// Wait for shutdown sig
	boot.WaitForShutdownSig(context.Background())
}

// @Summary Greeter service
// @Id 1
// @version 1.0
// @produce application/json
// @Param name query string true "Input name"
// @Success 200 {object} GreeterResponse
// @Router /v1/greeter [get]
func Greeter(ctx echo.Context) error {
	panic("Panic manually!")
}

2.验证

$ curl "localhost:8080/v1/greeter?name=rk-dev"
{
    "error":{
        "code":500,
        "status":"Internal Server Error",
        "message":"Panic manually!",
        "details":[]
    }
}

源代码

rk-boot 里对于错误的处理，实现于 rk-common/error 中。

Echo 框架: RPC 错误码设计

Echo 框架: RPC 错误码设计

介绍

考虑范围

错误码结构

安装

快速开始

1.创建 boot.yaml

2.创建 main.go

3.启动 main.go

4.验证

捕获 Panic（系统崩溃）

1.修改 main.go

2.验证

源代码

更多例子

社区

活动

资源

关于

腾讯云开发者

热门产品

热门推荐

更多推荐