Series Go Backend: Custom Errors - Bọc lỗi (Error Wrapping) với fmt.Errorf và errors.Is/As
Trong bài trước, chúng ta đã biết cách tạo ra các lỗi đơn giản bằng chuỗi text. Tuy nhiên, trong một kiến trúc Backend thực tế (như Clean Architecture), một request thường phải đi qua nhiều tầng: Controller ➔ Service ➔ Repository ➔ Database.
Nếu Database quăng ra một lỗi, và bạn chỉ đơn thuần ném thẳng nó lên Controller, người dùng sẽ nhận được một dòng chữ tối nghĩa như "connection refused". Họ sẽ không biết kết nối nào bị từ chối và trong quá trình làm gì? Chúng ta cần bổ sung thêm ngữ cảnh (context) cho lỗi ở từng tầng mà không làm mất đi bản chất của lỗi gốc.
1. Vấn đề: Sự phá hủy của %v
Cách truyền thống mà nhiều lập trình viên mới thường làm để thêm ngữ cảnh là nối chuỗi bằng %v:
Go
func getUserFromDB(id int) error {
return errors.New("record not found") // Lỗi gốc từ DB
}
func GetUserLogic(id int) error {
err := getUserFromDB(id)
if err != nil {
// Nối chuỗi để thêm ngữ cảnh
return fmt.Errorf("lỗi ở tầng service: %v", err)
}
return nil
}
Vấn đề chết người: Lỗi trả về bây giờ là một chuỗi MỚI hoàn toàn: "lỗi ở tầng service: record not found". Nếu Controller muốn kiểm tra xem lỗi này có phải là lỗi "Không tìm thấy dữ liệu" để trả về HTTP Status 404 Not Found hay không, nó sẽ không thể so sánh bằng phép == được nữa. Bản chất của lỗi gốc đã bị "nuốt chửng" và biến thành một chuỗi văn bản thông thường.
2. Giải pháp: Error Wrapping với %w (Từ Go 1.13)
Để giải quyết vấn đề trên, Go cung cấp format verb %w (Wrap). Thay vì hòa tan lỗi cũ vào chuỗi mới, %w sẽ bọc (wrap) lỗi cũ vào bên trong lỗi mới, giống như cấu trúc của một củ hành tây nhiều lớp.
Go
func GetUserLogic(id int) error {
err := getUserFromDB(id)
if err != nil {
// Sử dụng %w thay vì %v
// Lỗi gốc (err) vẫn được bảo toàn bên trong lỗi mới
return fmt.Errorf("lỗi ở tầng service: %w", err)
}
return nil
}
Lúc này, lỗi trả về tạo thành một chuỗi liên kết (Error Chain): [Error: "lỗi ở tầng service"] ➔ trỏ tới ➔ [Error: "record not found"]
3. errors.Is: Truy tìm dấu vết lỗi (Sentinel Errors)
Khi bạn sử dụng %w để bọc lỗi, bạn không thể dùng phép toán err == ErrNotFound để kiểm tra được nữa, vì lớp vỏ ngoài cùng đã thay đổi. Đây là lúc errors.Is tỏa sáng.
Trong Go, chúng ta thường định nghĩa các biến lỗi toàn cục (gọi là Sentinel Errors) để đại diện cho các trạng thái cụ thể.
Go
package main
import (
"errors"
"fmt"
)
// Khai báo Sentinel Error
var ErrRecordNotFound = errors.New("dữ liệu không tồn tại trong DB")
func fetchDB() error {
return ErrRecordNotFound
}
func process() error {
err := fetchDB()
if err != nil {
return fmt.Errorf("quá trình xử lý thất bại: %w", err) // Bọc lỗi
}
return nil
}
func main() {
err := process()
// Nếu dùng (err == ErrRecordNotFound) sẽ ra FALSE vì lỗi đã bị bọc
// Hàm errors.Is sẽ tự động "lột" từng lớp vỏ của củ hành
// và kiểm tra xem có lớp nào khớp với ErrRecordNotFound hay không
if errors.Is(err, ErrRecordNotFound) {
fmt.Println("Gửi HTTP 404 cho Client: Dữ liệu không tìm thấy")
} else {
fmt.Println("Gửi HTTP 500: Lỗi hệ thống chưa xác định")
}
}
4. Custom Error Struct và errors.As
Đôi khi, một chuỗi báo lỗi là không đủ. Bạn cần trả về một lỗi chứa nhiều dữ liệu phức tạp hơn (ví dụ: chứa mã HTTP Code, hoặc chứa danh sách các trường bị validate sai). Bạn có thể tự định nghĩa một Custom Error Struct bằng cách triển khai hàm Error().
Go
// Định nghĩa Custom Error
type APIError struct {
StatusCode int
Message string
}
// Triển khai interface error cho APIError (Dùng Pointer Receiver)
func (e *APIError) Error() string {
return fmt.Sprintf("[HTTP %d] %s", e.StatusCode, e.Message)
}
Giả sử ở một tầng sâu thẳm trong hệ thống, bạn trả về *APIError này và nó bị bọc lại nhiều lần bằng %w. Khi về đến Controller, làm sao để "moi" được cái StatusCode = 400 ra để trả về cho User? Hàm errors.As sinh ra để làm việc này.
Go
func main() {
// 1. Tạo lỗi gốc chứa dữ liệu
originalErr := &APIError{StatusCode: 400, Message: "Email không hợp lệ"}
// 2. Lỗi này bị bọc lại ở tầng Service
wrappedErr := fmt.Errorf("service validation failed: %w", originalErr)
// 3. Tại Controller, chúng ta muốn lấy lại struct APIError
// Khai báo một biến rỗng có kiểu con trỏ *APIError
var apiErr *APIError
// errors.As sẽ đào sâu vào chuỗi lỗi, tìm xem có lỗi nào thuộc kiểu *APIError không.
// Nếu có, nó sẽ gán (copy) dữ liệu vào biến apiErr và trả về true.
if errors.As(wrappedErr, &apiErr) {
fmt.Printf("Trích xuất thành công! Trả về HTTP Code: %d\n", apiErr.StatusCode)
fmt.Printf("Chi tiết lỗi: %s\n", apiErr.Message)
} else {
fmt.Println("Đây không phải là APIError")
}
}
Bí kíp thực chiến Backend:
Sử dụng
errors.Iskhi bạn quan tâm đến Giá trị (Value) của lỗi (Ví dụ: So sánh với biếnErrUserNotFoundtoàn cục).Sử dụng
errors.Askhi bạn quan tâm đến Kiểu (Type) của lỗi và muốn trích xuất dữ liệu từ nó (Ví dụ: Lấy mã HTTP Code ra khỏiAPIError).
Việc kết hợp %w, errors.Is, và errors.As giúp ứng dụng Backend của bạn có được những bộ log cực kỳ chi tiết (giữ nguyên stack trace ngữ cảnh) nhưng vẫn đảm bảo Controller luôn biết cách trả về HTTP Status Code chuẩn xác cho Client.
All rights reserved