Belajar Fiber - Breaking Changes dan Migrasi dari v2

#Pendahuluan

Fiber v3 membawa banyak peningkatan, tapi juga perubahan yang memecah kompatibilitas dengan v2. Episode 11 merangkum breaking changes paling penting dan cara memigrasi aplikasi yang sudah ada — terutama jika kalian pernah memakai Fiber v2.

Kabar baiknya: mayoritas API inti tetap sama. Perubahan yang ada sebagian besar menyederhanakan cara penulisan route dan konsisten dengan pembaruan di sisi middleware. Dengan daftar ini, migrasi bisa dilakukan secara bertahap tanpa menulis ulang semuanya.

#Perubahan Utama di Routing

#Variadic Handler untuk Mendaftarkan Route

Perubahan paling mencolok: method route kini menerima ...any sehingga bisa mendaftarkan banyak route dalam satu panggilan:

app.Get("/:id", handler)                       // v2
app.Get("/:id", handler)                       // v3
app.Get("/:id", handler, "user/:id", handler2) // v3: banyak route

Di v3, string bisa diselipkan di antara handler untuk memulai route baru. Perilaku handler biasa tidak berubah, jadi kode v2 tetap berjalan. Yang baru adalah kemampuan mendaftarkan beberapa route sekaligus.

#Method Use dan Add

app.Use dan app.Add di v3 menerima parameter variadic dengan aturan baru. Middleware yang dipanggil dengan prefix path berubah perilakunya:

app.Use("/user/:id", middleware) // v3: path parameter didukung

app.Use("/user/:id", middleware) kini mendukung path parameter pada prefix — di v2 hanya path statis. Ini membuat middleware bisa menyaring request berdasarkan nilai parameter di jalurnya, bukan hanya prefix literal.

#Perubahan di Context

#Akses Response Body

Cara membaca body response berubah. Body harus dibaca dari pointer c.Response().Body() yang menunjuk objek response:

body := string(c.Response().Body())
fmt.Println(body)

Di v2 c.Response().Body() mengembalikan slice byte; di v3 ia mengembalikan pointer ke objek response, sehingga perlu dereference. Ini berpengaruh di middleware yang membaca respons — misalnya untuk logging body atau cache.

#Request Body vs c.Body

Fiber v3 lebih tegas membedakan body request mentah dengan hasil parsing:

raw := c.Request().Body()   // []byte mentah dari request
parsed := c.Body()          // body setelah diproses

c.Request().Body() mengembalikan body mentah; c.Body() mengembalikan body yang sudah diproses Fiber. Jika sebuah handler menulis ulang body request, nilai c.Body() dan c.Request().Body() bisa berbeda.

#Perubahan di Middleware

#Adaptor dan Middleware Lain

Beberapa middleware ikut berubah mengikuti API baru. Contoh paling terlihat adalah package adaptor dan CSRF:

app.Use(csrf.New(csrf.Config{
    KeyLookup: "header:X-CSRF-Token",
    ErrorHandler: func(c fiber.Ctx, err error) error {
        return c.Status(fiber.StatusForbidden).JSON(fiber.Map{
            "error": err.Error(),
        })
    },
}))

csrf.Config kini memakai ErrorHandler func(c, error) — menandakan perubahan pola penanganan error di banyak middleware. Saat migrasi, periksa halaman dokumentasi tiap middleware yang dipakai: beberapa mengubah nama field atau signature handler.

#Memanfaatkan Fitur Baru

#Contoh: Variadic Route

Salah satu keuntungan migrasi adalah fitur yang tidak ada di v2. Contohnya variadic route:

app.Get("/a", handlerA, "b", handlerB)

Satu panggilan mendaftarkan dua route sekaligus. Fitur lain yang hanya ada di v3 — route constraints seperti :id<int>, domain routing, dan route chaining — bisa dipakai untuk menyederhanakan kode yang tadinya rumit. Terapkan fitur baru setelah migrasi dasar selesai, bukan di tengah proses.

#Strategi Migrasi

#Langkah Bertahap

go get github.com/gofiber/fiber/v3@latest

Langkah yang disarankan: 1) update versi fiber di go.mod, 2) jalankan go vet dan build untuk menemukan error kompilasi, 3) perbaiki akses response body yang berubah pointer, 4) sesuaikan middleware yang dipakai — mulai dari adaptor dan CSRF, 5) gunakan fitur baru seperti variadic handler secara bertahap, 6) jalankan ulang seluruh test suite.

#Penutup

Inti yang harus dibawa pulang:

• Variadic ...any di method route memungkinkan banyak route dalam satu panggilan.
• app.Use("/user/:id", middleware) mendukung path parameter di v3.
• c.Response().Body() kini mengembalikan pointer, perlu dereference.
• c.Request().Body() (mentah) berbeda dengan c.Body() (terproses).
• Beberapa middleware, seperti CSRF, mengubah signature config dan error handler.
• Migrasi bertahap: update versi, perbaiki kompilasi, sesuaikan middleware, lalu tes.

Di episode 12 selanjutnya kita membahas tips performance dan best practices — kaitkan dengan template rendering github.com/gofiber/template dan cara menangani file serta folder asset publik.