Frontend situs ini sudah dikompilasi menjadi HTML statis. Nginx menyajikan halaman hasil kompilasi dan berkas media secara langsung, tetapi proses worker-nya justru menghabiskan CPU jauh lebih banyak daripada yang diperkirakan untuk permintaan biasa. Tidak ada proses rendering Next.js per permintaan yang perlu dioptimalkan. Operasi mahal itu terjadi lebih awal: nginx harus menentukan apakah setiap URL termasuk dalam kumpulan aturan pengalihan lama yang terus bertambah.
Perbaikan yang akhirnya diterapkan tetap menjaga tautan lama agar berfungsi. Pengalihan halaman, alias gambar bernomor, dan alias video tetap dipertahankan, tetapi ribuan perbandingan ekspresi reguler diganti dengan sejumlah kecil pencocokan struktur path dan pencarian melalui tabel hash. Perubahan ini diterapkan lalu diuji terhadap perilaku perutean sebelumnya. Pengujian performa terkontrol yang diulang beberapa kali menunjukkan penurunan waktu CPU worker nginx lebih dari seratus kali lipat untuk campuran permintaan yang diuji, tanpa mengubah respons HTTP-nya.
Mengapa situs Next.js hasil ekspor statis masih membebani CPU
Ekspor statis memindahkan proses rendering halaman ke luar jalur penanganan permintaan, tetapi tidak menghilangkan logika perutean nginx. Sebelum menyajikan halaman HTML atau gambar, nginx mungkin perlu menormalkan path, mengevaluasi map pengalihan, memilih location, memeriksa keberadaan berkas, dan menyusun respons. Sistem berkas yang cepat tidak dapat mengimbangi pencocokan URL mahal yang diulang pada setiap permintaan.
Konfigurasi tersebut telah mengumpulkan dua jenis aturan lama yang berbeda. Alias halaman lama dengan pencocokan persis mengarah ke path kanonis baru. Alias paginasi juga mengalihkan path yang sudah tidak digunakan, tetapi mengikuti pola struktur yang sama. Secara terpisah, path media yang telah berganti nama memakai ekspresi yang menangkap nomor gambar opsional, sedangkan nama video memiliki aturan alias tersendiri. Masalahnya bukan keberadaan pengalihan, melainkan banyaknya kelompok pengalihan dengan struktur serupa yang ditulis sebagai regex terpisah.
Singkirkan lebih dulu kemungkinan penyebab lain dengan gejala CPU serupa
Situs berjalan di Linux yang tervirtualisasi, sehingga waktu CPU yang diambil hypervisor (CPU steal) menjadi salah satu dugaan awal. Saya membandingkan penggunaan CPU, waktu steal, pemakaian CPU per proses, tekanan memori, dan waktu tunggu disk, alih-alih menganggap nilai load average yang tinggi sebagai diagnosis. Alat dasar yang saya gunakan adalah:
mpstat -P ALL 1 5
pidstat -u -C nginx 1 5
vmstat -w 1 6
MASTER=$(systemctl show nginx -p MainPID --value)
WORKERS=$(pgrep -P "$MASTER" -d,)
perf record -F 49 -g -p "$WORKERS" -- sleep 10
perf report --stdio --no-children -g none
Temuan utamanya: proses worker nginx memakai banyak CPU di ruang pengguna, sementara CPU steal relatif kecil. Pengukuran tidak mendukung waktu tunggu disk yang berkepanjangan atau aktivitas swap sebagai penjelasan utama. Data per proses menunjukkan program mana yang sibuk; perf membantu menentukan apa yang dikerjakannya.
Dalam salah satu sampel, sekitar sepertiga aktivitas CPU yang tersampel berasal dari pcre_exec, dengan tambahan waktu pada ngx_http_regex_exec dan ngx_regex_exec. Fungsi-fungsi tersebut memang lazim muncul saat nginx menjalankan ekspresi reguler melalui PCRE. Profil ini tidak membuktikan map pengalihan tertentu mana yang menjadi penyebab, tetapi membuat evaluasi regex berulang jauh lebih masuk akal dibandingkan masalah rendering HTML statis.
Biaya tersembunyi entri regex berurutan dalam map nginx
map di nginx tidak otomatis lambat. Kunci string literal dapat dicari secara efisien, sedangkan entri regex diperiksa menurut urutan konfigurasi setelah kategori pencocokan yang memiliki prioritas lebih tinggi. Variabel map dievaluasi ketika dirujuk, jadi map regex yang besar menjadi masalah apabila hasilnya digunakan pada jalur permintaan yang sering dilewati. Gambar kanonis yang sudah ada tetapi tidak cocok dengan satu pun alias lama bisa harus melalui banyak perbandingan yang gagal sebelum nginx menyajikan datanya.
Perbedaan ini juga menjelaskan mengapa sekadar menghitung semua blok location ~ akan menyesatkan. Pemilihan location berbasis regex dan evaluasi regex di dalam map adalah dua mekanisme berbeda. Profiling menunjukkan jenis pekerjaan yang mahal; pemeriksaan jalur permintaan dan bagian konfigurasi yang menggunakan variabel menunjukkan di mana pekerjaan itu dipicu.
Penyelidikan lebih lanjut mengungkap bahwa daftar media bukan satu-satunya sumber masalah. Sekelompok aturan pengalihan halaman paginasi yang terpisah juga menimbulkan banyak pekerjaan regex saat map-nya dievaluasi. Mengoptimalkan gambar saja tidak akan menghilangkan biaya lain tersebut.
Pengalihan halaman: satu pola paginasi, tetapi ribuan tujuan spesifik
Aturan halaman bersifat berulang: path hanya berbeda pada pengenal lama, sedangkan bagian akhirnya mengikuti pola paginasi seperti /topics/old-a/page/99. Sekilas, solusi yang menarik adalah mengekstrak 99 lalu menambahkannya ke slug baru. Namun, hasilnya keliru. Sebagian aturan paginasi lama sengaja memetakan setiap nomor halaman yang diminta ke satu halaman tujuan tetap, misalnya /topics/current-a/page/7, terlepas dari apakah permintaan asalnya untuk halaman 3 atau 99.
Ada batasan penting lain: nginx memprioritaskan kunci map yang cocok persis dibandingkan regex. Sebagian entri persis menimpa hasil aturan paginasi umum. Entri lain secara eksplisit memetakan ke string kosong untuk mencegah pengalihan path yang sudah kanonis. Jika hanya memeriksa apakah tujuan yang dikembalikan tidak kosong, perbedaan antara tidak ada kecocokan persis dan ada kecocokan persis dengan nilai kosong akan hilang.
Penggantinya memisahkan pengenalan path dari pemilihan tujuan. Berikut contoh ringkas dan sintetis dari map nginx pada tingkat http:
# http context: synthetic page aliases
map $uri $normalized_path {
default $uri;
~^(.+)/$ $1;
}
map $normalized_path $exact_target {
default "__NO_EXACT__";
/topics/old-a /topics/current-a;
/topics/old-a/page/2 /topics/current-a/page/2;
/topics/old-b/page/2 "";
}
map $normalized_path $pagination_key {
default "";
~^/(?<old_root>topics/[a-z0-9-]+)/page/[1-9][0-9]*$ /$old_root;
}
map $pagination_key $pagination_target {
default "";
/topics/old-a /topics/current-a/page/7;
/topics/old-b /topics/current-b/page/6;
}
map $exact_target $redirect_target {
default $exact_target;
__NO_EXACT__ $pagination_target;
}
Map pertama mempertahankan normalisasi garis miring di akhir path. Map kedua menyimpan pengalihan persis dan pengecualian eksplisit bernilai kosong, dengan sebuah nilai penanda yang berarti tidak ada entri persis. Map ketiga menggunakan satu regex untuk mengekstrak akar path paginasi. Map keempat mencari akar tersebut melalui kunci persis untuk mendapatkan tujuan tetap aslinya. Terakhir, pemilih tujuan menghormati setiap kecocokan persis, termasuk pengecualian kosong, sebelum mempertimbangkan hasil paginasi.
Server kemudian dapat menggunakan nilai $redirect_target yang dihasilkan hanya jika tidak kosong, sambil mempertahankan status HTTP semula dan menambahkan $is_args$args jika kebijakan yang berlaku memang mempertahankan string kueri. Nilai penanda harus dicadangkan dan divalidasi agar tidak pernah berbenturan dengan tujuan nyata. Contoh ini memakai path netral; generator untuk produksi tetap harus mempertahankan seluruh inventaris pemetaan dan urutan prioritas yang berlaku.
Perilaku terkait huruf besar dan kecil mudah terlewat dalam rancangan ini. Nginx membandingkan kunci string literal pada map tanpa membedakan huruf besar dan kecil, sedangkan regex yang ditulis dengan ~ peka terhadap perbedaan tersebut. Karena itu, penggantinya tidak bisa sembarangan mengubah semua URL menjadi huruf kecil, atau mengganti aturan ~ menjadi ~*, lalu menganggap hasilnya setara. Semantik pencocokan semula harus tetap sama.
Pengalihan gambar dan video: uraikan path sekali, lalu cari kunci lama
Aturan media memiliki struktur serupa yang juga bisa dimanfaatkan. Path gambar lama mengandung pengenal galeri pada direktori sekaligus nama berkasnya, dengan akhiran angka opsional: /old-gallery/old-gallery-17.avif. Path tujuan menggunakan kembali akhiran tersebut, tetapi mengganti direktori dan awalan nama berkas. Membuat regex untuk setiap galeri lama dan setiap bentuk akhiran membuang CPU untuk membandingkan pola yang sebenarnya memakai tata nama sama.
Map yang lebih efisien mengekstrak pengenal dan akhiran opsional dengan satu regex, lalu mencari awalan baru memakai kunci literal:
# http context: synthetic AVIF rename inventory
map $uri $legacy_image_key {
default "";
~^/(?<old_id>[a-z0-9-]+)/\k<old_id>(?<image_number>-[0-9]+)?\.avif$ $old_id;
}
map $legacy_image_key $new_image_prefix {
default "";
old-gallery /new-gallery/new-gallery;
old-set /new-set/new-set;
}
# A recognized alias now has a target candidate:
# $new_image_prefix$image_number.avif
# Existing-file checks and the actual 301 remain
# in the site's media-serving configuration.
Untuk alias yang dikenali, /old-gallery/old-gallery-17.avif menghasilkan kandidat tujuan /new-gallery/new-gallery-17.avif. Ini adalah mekanisme pencarian, bukan kebijakan penyajian berkas yang lengkap. Dalam penerapan sebenarnya, prioritas berkas yang sudah ada, pemeriksaan keberadaan berkas tujuan, dan keputusan untuk mengirim 301 tetap berada di konfigurasi penyajian media. Pengalihan 301 tanpa syarat dalam contoh sederhana akan menjadi pengganti yang salah apabila berkas tujuan tidak ada.
Pengalihan video menggunakan tabel kunci persis yang serupa, didahului satu regex untuk mengenali bentuk nama berkas. Jalur kompatibilitas WebP yang sudah ada, yang menormalkan pencarian alias lamanya agar menggunakan pemetaan gambar, juga harus tetap berfungsi. Optimasi media baru bisa disebut berhasil jika berkas saat ini tetap mengembalikan byte dan header yang benar, serta akses melalui alias video lama masih mendukung 206 Partial Content untuk permintaan rentang byte.
Contoh-contoh ini hanya berhasil karena inventaris lama mengikuti tata nama berkas yang dapat diprediksi. Jika setiap berkas berganti nama secara terpisah dan tanpa pola, rancangan yang aman harus memakai kunci persis untuk tiap berkas, indeks yang dihasilkan secara otomatis, atau mekanisme pencarian lain dengan biaya terbatas—bukan berpura-pura satu regex bisa menyusun kembali tujuan yang tidak memiliki pola bersama.
Apa yang terjadi pada map 410 yang terpisah
Bagian lain konfigurasi secara eksplisit mencantumkan pola halaman yang sudah dihentikan hanya untuk mengembalikan 410 Gone. Map khusus itu dihapus setelah dipastikan bahwa kebijakan perutean berkas statis yang sudah ada memang mengembalikan 410 untuk halaman yang benar-benar tidak ditemukan. Metadata mengenai halaman lama yang dihentikan tetap tersedia untuk validasi; yang dihapus hanya pencocokan berulang saat permintaan diproses.
Ini adalah keputusan khusus untuk konfigurasi tersebut, bukan perilaku bawaan nginx. Penggunaan try_files tanpa pengaturan tambahan sering berakhir dengan 404. Menghapus aturan 410 eksplisit hanya aman jika jalur penanganan sumber daya yang hilang di server sebenarnya tetap menghasilkan 410 yang diwajibkan, termasuk untuk URL paginasi lama dan penanganan halaman kesalahan internal. Kondisi tersebut diperiksa melalui permintaan HTTP nyata sebelum perubahan diterima.
Cara membuktikan map pengalihan yang lebih cepat tetap berperilaku sama
Konfigurasi nginx yang valid secara sintaksis masih dapat merusak ribuan tautan lama tanpa terlihat. Karena itu, penggantiannya menggunakan inventaris aturan asli sebagai masukan pemeriksaan kebenaran yang independen, bukan kumpulan tujuan yang disusun ulang dari keluaran hasil optimasi. Tabel pencarian yang dihasilkan diperiksa untuk mendeteksi kunci duplikat, ekspresi yang tidak didukung, awalan gambar yang tidak konsisten, serta berkas hasil generasi yang sudah usang. Aturan yang tidak bisa diwakili dengan aman harus membuat proses generasi gagal, bukan menghilang begitu saja.
Matriks pengujian mencakup alias halaman dengan kecocokan persis, pengecualian kanonis bernilai kosong, aturan paginasi yang tumpang tindih, batas paginasi dengan tujuan tetap, nomor halaman valid dan tidak valid, garis miring di akhir path, variasi huruf besar-kecil, serta string kueri. Untuk media, pengujian mencakup gambar dasar dan gambar bernomor, akhiran yang diawali nol, pengenal yang diakhiri digit, path tujuan bertingkat, kompatibilitas WebP, serta alias video asli. Saat penyajian berkas relevan, pengujian memakai berkas contoh yang benar-benar bisa dibaca dan membandingkan isi respons, pengalihan, header terkait cache, serta rentang byte video.
Yang terpenting, ini adalah pengujian HTTP nyata melalui nginx, bukan sekadar perbandingan string di JavaScript. Konfigurasi baru diuji dengan seluruh matriks permintaan yang dihasilkan, sementara serangkaian permintaan terpisah diperiksa terhadap konfigurasi asli berbasis PCRE. Hasil yang dilaporkan menunjukkan tidak ada perbedaan respons yang tidak disengaja. Pengujian singkat di produksi setelahnya memastikan bahwa berkas konfigurasi yang dimuat melalui include dan telah dioptimalkan memang aktif, sedangkan tabel regex panjang sebelumnya tidak lagi aktif.
Benchmark terkontrol memisahkan dampak optimasi dari perubahan trafik
Grafik penggunaan CPU di produksi membaik secara signifikan setelah penerapan, tetapi jumlah dan komposisi permintaan juga berubah. Membandingkan satu sampel saat sibuk dengan sampel berikutnya saat sepi akan melebih-lebihkan dampak yang bisa diatribusikan kepada perubahan konfigurasi.
Untuk mengisolasi biaya pencarian, benchmark independen menggunakan binari nginx yang sama dan mengulang urutan permintaan campuran yang identik pada konfigurasi asli dan konfigurasi hasil optimasi. Urutan itu mencakup halaman kanonis, alias halaman lama, alias paginasi, halaman yang tidak ditemukan, gambar kanonis, alias gambar dan video lama, serta media yang tidak ditemukan. Pengujian dijalankan bergantian dengan urutan lama, baru, baru, lama; status respons dan nilai Location cocok.
Pada beban kerja terkontrol tersebut, map hasil optimasi menghabiskan waktu CPU worker nginx kurang dari seperseratus dibandingkan map lama yang sarat regex, dan hasilnya terulang pada beberapa pengujian. Ini merupakan pengukuran yang kuat atas perubahan pemrosesan pengalihan untuk campuran permintaan tersebut. Namun, ini bukan berarti setiap permintaan di produksi menjadi 100 kali lebih cepat, atau total penggunaan CPU server akan turun dengan rasio yang sama pada semua jenis trafik.
Pemeriksaan sistem berikutnya menunjukkan penggunaan CPU nginx rendah, tekanan disk kecil, dan banyak waktu CPU menganggur. Titik panas PCRE sebelumnya tidak lagi mendominasi sampel pascaperubahan yang tersedia; pada tingkat pemakaian serendah itu, jumlah sampelnya sedikit sehingga persentase per fungsi tidak boleh ditafsirkan berlebihan. Perbandingan terkontrol, pengujian kesetaraan perilaku, dan keberhasilan penerapan merupakan bukti yang lebih kuat untuk perbaikan ini.
Alur kerja yang lebih aman untuk migrasi pengalihan nginx berskala besar
Untuk situs lain yang memiliki banyak URL lama, saya akan menjaga migrasi tetap mekanis: mempertahankan inventaris aturan asli, mengidentifikasi sejumlah kecil pola penulisan path yang sama, mengompilasi setiap pola menjadi regex dengan cakupan terbatas, dan menyimpan tujuan dalam map berkunci literal. Perlakukan pengecualian kanonis dengan kecocokan persis, kode status HTTP, pemeriksaan keberadaan berkas, string kueri, kanonisasi host, dan kepekaan huruf besar-kecil sebagai perilaku yang terlihat oleh publik, bukan detail implementasi yang boleh diabaikan.
Selanjutnya, validasi seluruh konfigurasi yang dihasilkan dengan nginx -t, bandingkan perilaku lama dan baru melalui nginx sungguhan, jalankan benchmark dengan permintaan identik, lalu terapkan dengan cadangan yang bisa dipulihkan dan pemeriksaan setelah reload. Jika suatu pengalihan tidak dapat diwakili oleh skema berbasis struktur, pertahankan pengecualian yang dibatasi secara spesifik atau gunakan entri persis per URL, alih-alih diam-diam menghapusnya.
Perubahan cara mendiagnosis yang paling berguna adalah menyadari bahwa penyajian berkas statis dan perutean yang ringan merupakan dua sifat berbeda. Next.js sudah menyelesaikan pekerjaan rendering, dan nginx mampu menyajikan berkas dengan efisien. Optimasi yang sebelumnya hilang adalah pencarian yang dijalankan sebelum berkas tersebut disajikan. Menjaga tautan lama tetap berfungsi ternyata tidak bertentangan dengan membuat pencarian itu cepat.
Untuk aturan prioritas dan evaluasi yang tepat, lihat dokumentasi resmi nginx tentang modul map dan pemilihan location pada HTTP core.