Error paling umum setelah upgrade ke Next.js 16 mencakup build gagal karena konfigurasi webpack terdeteksi Turbopack, akses sinkron ke `params`/`searchParams`/`cookies()`/`headers()` yang kini benar-benar dilarang (bukan sekadar warning), parallel routes tanpa `default.js`, dan `revalidateTag()` dengan satu argumen yang jadi error TypeScript.

**Ringkasan cepat:**

1. Next.js 16 mengubah warning masa transisi Next.js 15 jadi error keras: konfigurasi webpack yang terdeteksi Turbopack, akses sinkron ke `params`/`searchParams`/`cookies()`/`headers()`, parallel routes tanpa `default.js`, dan `revalidateTag()` dengan satu argumen.
2. Jalankan `npx @next/codemod@canary upgrade latest` lebih dulu sebelum debugging manual — migrasi mekanis (konfigurasi Turbopack, rename `middleware` ke `proxy`, penghapusan prefix `unstable_`) sudah otomatis tertangani.
3. Error "webpack config found" diperbaiki dengan memindahkan opsi ke properti `turbopack` top-level, atau tetap pakai `next build --webpack` kalau belum siap migrasi penuh.
4. Akses `params`/`searchParams`/`cookies()`/`headers()` wajib pakai `await` — jalankan codemod `next-async-request-api` untuk migrasi otomatis, lalu `npx next typegen` untuk regenerasi tipe bantuan.
5. Parallel routes (folder berawalan `@`) wajib punya `default.js`, dan `revalidateTag()` sekarang butuh argumen kedua berupa profil `cacheLife` (atau pakai `updateTag()` di Server Action untuk efek read-your-writes).

## Kenapa Next.js 16 Sering Error Setelah Upgrade?

Next.js 15 memperkenalkan banyak perubahan sebagai peringatan (warning) dengan periode transisi sinkron-asinkron yang masih dibolehkan sementara. Menurut [panduan resmi upgrade ke versi 16](https://nextjs.org/docs/app/guides/upgrading/version-16), periode transisi itu berakhir total di versi 16: kode yang di Next.js 15 cuma menampilkan warning di console sekarang benar-benar gagal build atau error di runtime. Turbopack juga berubah dari opsional (`--turbopack`) menjadi default penuh untuk `next dev` maupun `next build`.

### Cara Cepat Melihat Semua Error Sekaligus

Jalankan `npx @next/codemod@canary upgrade latest` dulu sebelum debugging manual — codemod ini otomatis menangani migrasi konfigurasi Turbopack, migrasi `middleware` ke `proxy`, dan penghapusan prefix `unstable_`. Baru setelah itu jalankan `npm run build` untuk melihat error yang tersisa satu per satu.

## Error Apa Saja yang Paling Sering Muncul Setelah Upgrade Next.js 16?

| Error/Peringatan | Penyebab | Perbaikan Singkat |
| --- | --- | --- |
| Build gagal, disebut konfigurasi `webpack` ditemukan | `next.config.ts` punya opsi `webpack` (manual atau dari plugin pihak ketiga), sedangkan `next build` kini memakai Turbopack secara default | Migrasi ke opsi `turbopack`, atau jalankan `next build --webpack` |
| Akses `params`/`searchParams`/`cookies()`/`headers()` sinkron gagal total | Periode transisi sinkron Next.js 15 sudah berakhir di versi 16 | Bungkus dengan `await`, jalankan codemod `next-async-request-api` |
| Build gagal di parallel routes | Slot parallel routes (mis. `@modal`) tidak punya `default.js` | Tambahkan `default.js` yang memanggil `notFound()` atau `return null` |
| `revalidateTag()` error TypeScript | `revalidateTag()` sekarang wajib argumen kedua berupa profil `cacheLife` | Ubah `revalidateTag('tag')` jadi `revalidateTag('tag', 'max')`, atau pakai `updateTag()` |
| Error terkait `experimental.dynamicIO`/`experimental.useCache` | Kedua flag eksperimental ini sudah dihapus total di versi 16 | Ganti ke opsi top-level `cacheComponents: true`, atau hapus kalau memang tidak dipakai |

## Bagaimana Cara Memperbaiki Error "Webpack Config Found" Saat Build?

Turbopack sekarang jadi bundler default untuk `next build`, jadi kalau `next.config.ts` masih punya opsi `webpack` kustom, build akan **gagal** untuk mencegah konfigurasi yang salah terpakai secara diam-diam. Ada tiga jalan keluar sesuai dokumentasi resmi:

```bash
# 1. Tetap pakai Turbopack, abaikan konfigurasi webpack
next build --turbopack

# 2. Tetap pakai webpack sepenuhnya
next build --webpack
```

Kalau memilih migrasi penuh ke Turbopack, pindahkan opsi ke properti `turbopack` top-level di `next.config.ts` (bukan lagi di dalam `experimental.turbopack` seperti Next.js 15). Kalau errornya muncul padahal project sendiri tidak pernah menulis opsi `webpack`, cek dependency pihak ketiga (Sentry, plugin PWA, dll.) yang kemungkinan menambahkannya otomatis ke config. Migrasi ini bukan cuma soal menghilangkan error — lihat [dampak Turbopack jadi default di Next.js 16](/blog/turbopack-default-nextjs-16-dampaknya) untuk angka build 2-5x lebih cepat dan Fast Refresh hingga 10x yang jadi alasan Next.js mendorong migrasi ini.

## Bagaimana Cara Memperbaiki Error Akses Params dan SearchParams Sinkron?

Di Next.js 16, `params`, `searchParams`, `cookies()`, `headers()`, dan `draftMode()` **hanya** bisa diakses secara asinkron — akses sinkron yang di Next.js 15 masih sekadar warning sekarang benar-benar tidak berfungsi.

> Starting with Next.js 16, synchronous access is fully removed. These APIs can only be accessed asynchronously.
>
> — [Next.js 16 Upgrade Guide, bagian Async Request APIs](https://nextjs.org/docs/app/guides/upgrading/version-16#async-request-apis-breaking-change)

Jalankan codemod resmi untuk migrasi otomatis ke sebagian besar file:

```bash
npx @next/codemod@canary next-async-request-api .
```

Untuk kasus yang tidak tertangkap codemod, ubah manual dengan `await`:

```tsx
// Sebelum (Next.js 15, sinkron)
export default function Page({ params }: { params: { slug: string } }) {
  const { slug } = params;
  return <h1>{slug}</h1>;
}

// Sesudah (Next.js 16, wajib async)
export default async function Page({ params }: { params: Promise<{ slug: string }> }) {
  const { slug } = await params;
  return <h1>{slug}</h1>;
}
```

Jalankan `npx next typegen` setelah migrasi untuk menghasilkan ulang tipe bantuan `PageProps`/`LayoutProps`/`RouteContext` secara otomatis, supaya IDE langsung mendeteksi kalau ada akses sinkron yang terlewat.

## Kenapa Build Gagal Karena Parallel Routes Tanpa default.js?

Semua slot parallel routes (folder dengan awalan `@`, misalnya `@modal` atau `@sidebar`) sekarang **wajib** punya file `default.js` — tanpa itu, build langsung gagal. Sebelumnya Next.js diam-diam mengizinkan slot kosong tanpa fallback eksplisit.

> All parallel route slots now require explicit default.js files. Builds will fail without them.
>
> — [Next.js 16 Upgrade Guide, bagian Parallel Routes default.js requirement](https://nextjs.org/docs/app/guides/upgrading/version-16#parallel-routes-defaultjs-requirement)

```tsx
// app/@modal/default.tsx
import { notFound } from "next/navigation";

export default function Default() {
  notFound();
}
```

Atau cukup `return null` kalau slot tersebut memang boleh kosong tanpa memicu halaman 404.

## Bagaimana Cara Memperbaiki Error revalidateTag Setelah Upgrade?

`revalidateTag()` dengan satu argumen sekarang menghasilkan error TypeScript karena wajib argumen kedua berupa profil `cacheLife`:

```ts
// Sebelum — error TypeScript di Next.js 16
revalidateTag("posts");

// Sesudah — wajib sertakan profil cacheLife
revalidateTag("posts", "max");
```

Kalau butuh efek "read-your-writes" (perubahan langsung terlihat di request yang sama, bukan stale-while-revalidate), pakai `updateTag()` di dalam Server Action sebagai gantinya — fungsi baru yang memang dirancang untuk kasus itu, berbeda dari pola caching yang sudah dibahas di artikel [Cache Components Next.js 16](/blog/cache-components-nextjs-16-panduan-lengkap).

## Ringkasan: Codemod Dulu, Baru Perbaiki Empat Error Manual

- Jalankan `npx @next/codemod@canary upgrade latest` lebih dulu sebelum debugging manual — sebagian besar migrasi mekanis (konfigurasi Turbopack, rename `middleware` ke `proxy`, penghapusan prefix `unstable_`) sudah otomatis.
- Error paling sering: konfigurasi webpack yang terdeteksi Turbopack, akses sinkron ke `params`/`searchParams`/`cookies()`/`headers()` yang kini benar-benar dilarang, parallel routes tanpa `default.js`, dan `revalidateTag()` tanpa argumen kedua.
- Kalau upgrade-nya sendiri belum dijalankan, baca dulu langkah lengkapnya di [cara upgrade Next.js 15 ke Next.js 16](/blog/cara-upgrade-nextjs-15-ke-16-langkah-demi-langkah) sebelum masuk ke troubleshooting di artikel ini.
- Butuh bantuan mengaudit atau memperbaiki error upgrade Next.js di proyek sendiri? Lihat [layanan web development](/layanan) yang ditawarkan.