أساسيات الأخطاء

أساسيات الأخطاء — Error Basics

في أغلب اللغات، الأخطاء تُعالج عبر الاستثناءات (exceptions) — تُرمى في مكان وتُلتقط في مكان آخر. Go اختارت طريقاً مختلفاً تماماً: الأخطاء قيم عادية.

هذا يعني أنك تتعامل مع الخطأ كما تتعامل مع أي قيمة — تفحصه، تمرره، تغلّفه، أو تتجاهله (وهذا خطأ!).

واجهة error

error هو نوع مُدمج في Go — واجهة بأسلوب واحد:

type error interface {
    Error() string
}

أي نوع يُنفّذ Error() string يُعتبر خطأ. بهذه البساطة.

إنشاء أخطاء بسيطة

main.go

package main

import (
    "errors"
    "fmt"
)

// دالة قسمة — Division function
func divide(a, b float64) (float64, error) {
    if b == 0 {
        // إنشاء خطأ بسيط — Create simple error
        return 0, errors.New("لا يمكن القسمة على صفر")
    }
    return a / b, nil
}

// دالة مع تفاصيل — Function with details in error
func withdraw(balance, amount float64) (float64, error) {
    if amount <= 0 {
        // خطأ مع تنسيق — Error with formatting
        return balance, fmt.Errorf("مبلغ غير صالح: %.2f", amount)
    }
    if amount > balance {
        return balance, fmt.Errorf("رصيد غير كافٍ: لديك %.2f وتريد سحب %.2f", balance, amount)
    }
    return balance - amount, nil
}

func main() {
    // قسمة ناجحة — Successful division
    result, err := divide(10, 3)
    if err != nil {
        fmt.Println("خطأ:", err)
    } else {
        fmt.Printf("10 ÷ 3 = %.2f\n", result)
    }

    // قسمة على صفر — Division by zero
    _, err = divide(10, 0)
    if err != nil {
        fmt.Println("خطأ:", err)
    }

    // سحب ناجح — Successful withdrawal
    balance, err := withdraw(1000, 300)
    if err != nil {
        fmt.Println("خطأ:", err)
    } else {
        fmt.Printf("الرصيد المتبقي: %.2f\n", balance)
    }

    // سحب فاشل — Failed withdrawal
    _, err = withdraw(1000, 5000)
    if err != nil {
        fmt.Println("خطأ:", err)
    }
}

Output:

نمط if err != nil

هذا هو النمط الأساسي في Go — ستراه في كل مكان:

result, err := someFunction()
if err != nil {
    // تعامل مع الخطأ — Handle the error
    return err  // أو log أو retry
}
// استخدم result — Use result

نعم، هذا يعني كتابة if err != nil كثيراً. مجتمع Go يرى أن هذا ميزة وليس عيب — لأنه يجبرك على التفكير في كل حالة خطأ بدلاً من تجاهلها.

تغليف الأخطاء — Error Wrapping مع %w

عندما تلتقط خطأ من دالة داخلية وتريد إضافة سياق، استخدم %w:

main.go

package main

import (
    "errors"
    "fmt"
)

// خطأ أساسي — Base error
var ErrNotFound = errors.New("غير موجود")

// البحث في قاعدة البيانات — Search in database
func findUser(id int) (string, error) {
    if id != 1 {
        return "", ErrNotFound
    }
    return "أحمد", nil
}

// طبقة الخدمة — Service layer
func getUserProfile(id int) (string, error) {
    name, err := findUser(id)
    if err != nil {
        // تغليف الخطأ بسياق إضافي — Wrap error with context
        return "", fmt.Errorf("فشل تحميل ملف المستخدم %d: %w", id, err)
    }
    return fmt.Sprintf("الملف الشخصي: %s", name), nil
}

// طبقة المعالج — Handler layer
func handleRequest(id int) {
    profile, err := getUserProfile(id)
    if err != nil {
        // الخطأ يحمل كل السياق — Error carries full context
        fmt.Println("خطأ:", err)

        // يمكن فحص الخطأ الأصلي — Can check original error
        if errors.Is(err, ErrNotFound) {
            fmt.Println("→ السبب: المستخدم غير موجود")
        }
        return
    }
    fmt.Println(profile)
}

func main() {
    fmt.Println("=== مستخدم موجود ===")
    handleRequest(1)

    fmt.Println("\n=== مستخدم غير موجود ===")
    handleRequest(99)
}

Output:

لاحظ كيف أن %w يحفظ الخطأ الأصلي داخل الخطأ الجديد — مما يسمح لنا بفحصه لاحقاً بـ errors.Is.

الفرق بين %v و %w

// %v — ينسخ الرسالة فقط، يفقد الخطأ الأصلي
fmt.Errorf("فشل: %v", err)  // لا يمكن استخدام errors.Is بعدها

// %w — يغلّف الخطأ الأصلي، يحفظه
fmt.Errorf("فشل: %w", err)  // يمكن استخدام errors.Is

القاعدة: استخدم %w عندما تريد أن يبقى الخطأ الأصلي قابلاً للفحص.

تجاهل الأخطاء — Don’t!

أحد أخطر الأخطاء في Go هو تجاهل القيمة المُرجعة:

// ❌ خطير — تجاهل الخطأ
result, _ := riskyFunction()

// ✅ صحيح — تعامل مع الخطأ
result, err := riskyFunction()
if err != nil {
    log.Fatal(err)
}

تجاهل الخطأ مقبول فقط عندما تكون متأكداً تماماً أنه لن يحدث، أو أنك لا تهتم بالنتيجة (مثل fmt.Println التي نادراً ما تفشل).

أنماط شائعة

1. الإرجاع المبكر — Early return:

func processFile(path string) error {
    data, err := readFile(path)
    if err != nil {
        return fmt.Errorf("قراءة الملف: %w", err)
    }

    result, err := parse(data)
    if err != nil {
        return fmt.Errorf("تحليل البيانات: %w", err)
    }

    return save(result)
}

2. التجميع — collecting errors:

main.go

package main

import (
    "fmt"
    "strings"
)

// التحقق من صحة المدخلات — Input validation
func validateUser(name, email string, age int) error {
    var errs []string

    if name == "" {
        errs = append(errs, "الاسم مطلوب")
    }
    if !strings.Contains(email, "@") {
        errs = append(errs, "بريد إلكتروني غير صالح")
    }
    if age < 13 {
        errs = append(errs, "العمر يجب أن يكون 13 أو أكثر")
    }

    if len(errs) > 0 {
        return fmt.Errorf("أخطاء التحقق: %s", strings.Join(errs, "، "))
    }
    return nil
}

func main() {
    err := validateUser("", "invalid", 10)
    if err != nil {
        fmt.Println(err)
    }

    err = validateUser("أحمد", "ahmed@example.com", 25)
    if err != nil {
        fmt.Println(err)
    } else {
        fmt.Println("✅ البيانات صحيحة")
    }
}

Output:

تحدي — Challenge

package main

import (
    "errors"
    "fmt"
)

// خطأ أساسي — Base error
var ErrProductNotFound = errors.New("المنتج غير موجود")

// طبقة 1 — Layer 1
func findProduct(id int) error {
    return ErrProductNotFound
}

// طبقة 2 — Layer 2: غلّف الخطأ بـ %w
func searchProduct(id int) error {
    err := findProduct(id)
    if err != nil {
        // غلّف الخطأ باستخدام fmt.Errorf و %w — اكتب الكود هنا
        return err
    }
    return nil
}

// طبقة 3 — Layer 3: غلّف الخطأ بـ %w
func handleOrder(productID int) error {
    err := searchProduct(productID)
    if err != nil {
        // غلّف الخطأ باستخدام fmt.Errorf و %w — اكتب الكود هنا
        return err
    }
    return nil
}

func main() {
    err := handleOrder(42)
    if err != nil {
        fmt.Println("خطأ:", err)
        // استخدم errors.Is للتحقق من الخطأ الأصلي — اكتب الكود هنا
    }
}