MySQL Strict Mode di Laravel: Satu SET sql_mode yang Diam-diam Mengubah Data di Seluruh Aplikasi
- Authors

- Name
- Samsul Hadi
- Threads
- @Threads


Seorang pengguna mengosongkan kolom tahun pembangunan di formulir, lalu menekan simpan. Tidak ada error, tidak ada peringatan. Di database, tahun itu tersimpan sebagai 0000.
Di tempat lain, nama yang kepanjangan terpotong di karakter ke-20. Tidak ada yang tahu, karena aplikasinya tidak pernah mengeluh.
Ini saya temukan di aplikasi inspeksi berbasis Laravel di salah satu proyek klien yang saya pegang. Penyebabnya bukan satu bug, tapi dua keputusan kecil yang saling menguatkan. Yang pertama, setelan 'strict' => false di konfigurasi database yang sudah ada sejak Desember 2022, tanpa catatan alasannya. Yang kedua, satu method dashboard yang menjalankan SET sql_mode dan tidak pernah benar-benar mengembalikannya.
Artikel ini membahas apa yang dilakukan MySQL saat mode strict mati, kenapa satu SET sql_mode di satu method bisa memengaruhi semua query sesudahnya, dan cara menyalakan strict mode di aplikasi lama tanpa merusak semuanya. Semua screenshot berasal dari demo Laravel 12 dan MySQL 8 yang saya jalankan.
Apa yang dilakukan MySQL saat strict mode mati
Dengan STRICT_TRANS_TABLES aktif, MySQL menolak data yang tidak sesuai kolom: teks yang terlalu panjang, angka yang tidak valid, tanggal nol. Tanpa mode itu, MySQL tetap menyimpan data dengan cara yang menurutnya paling masuk akal, lalu hanya mencatat warning. Teks dipotong. Nilai tidak valid diubah menjadi nol. Laravel tidak menampilkan warning, jadi aplikasi menganggap semuanya berhasil.
Laravel sebenarnya menyalakan strict mode secara bawaan. Saat koneksi dibuka dengan 'strict' => true, Laravel menyetel sql_mode session ke daftar mode yang ketat. Dengan 'strict' => false, yang tersisa hanya NO_ENGINE_SUBSTITUTION.
Lalu ada masalah kedua. sql_mode adalah setelan per koneksi. Di PHP, satu request biasanya memakai satu koneksi database dari awal sampai akhir. Kalau satu method menjalankan SET sql_mode='', semua query sesudahnya di request itu ikut berjalan tanpa mode strict, termasuk query yang tidak ada hubungannya dengan method tersebut.
Di aplikasi itu, method ringkasan proyek di dashboard dibuka dengan SET sql_mode='' supaya satu query grouping tidak ditolak ONLY_FULL_GROUP_BY. Method itu ditutup dengan SET sql_mode='only_full_group_by', yang kelihatannya mengembalikan setelan. Padahal itu bukan setelan awal koneksi. Mode strict yang lain, termasuk STRICT_TRANS_TABLES, tetap hilang untuk sisa request.
Dua commit perbaikannya
Perbaikannya dua commit, 19 dan 20 Agustus 2026.
Commit pertama: dashboard berhenti mematikan strict mode. Saat ditelusuri, query yang dilindungi oleh SET sql_mode itu ternyata tidak dipakai. Hasilnya dikirim ke view, tapi tabel di dashboard digambar oleh komponen Livewire terpisah yang menghitung sendiri. Jadi query grouping dengan tiga subquery itu berjalan setiap dashboard dibuka, lalu hasilnya dibuang. Satu-satunya yang benar-benar dipakai dari method itu adalah waktu update terakhir proyek. Sekarang hanya itu yang dikerjakan method tersebut, dan kedua SET sql_mode hilang bersama query yang tidak dipakai.
Di commit yang sama ada temuan kecil: @section('page-styles') yang dibuka dan tidak pernah ditutup di view dashboard. Itu membuat Blade membocorkan output buffer setiap render, dan itulah alasan smoke test dashboard selama ini selalu dilaporkan "risky".
Commit kedua: strict mode dinyalakan, sesuai bawaan Laravel. Setelan 'strict' => false sudah ada sejak Desember 2022, ditambahkan di commit yang mengubah controller laporan, tanpa catatan alasan. Setelah dinyalakan, tes langsung memperlihatkan apa saja yang selama ini ditambal diam-diam oleh MySQL:
- Kolom
display_namedi tabel role dan permissionNOT NULLtanpa default. Kode yang membuat role tanpa nama tampilan selama ini mengandalkan MySQL menyimpan string kosong. Sekarang model membuat nama tampilan yang terbaca dari nama role-nya. - Package permission ternyata memakai model bawaannya sendiri, bukan model aplikasi, sehingga default tadi tidak pernah jalan. Konfigurasinya diarahkan ke model aplikasi.
- Sisanya fixture tes yang memasukkan baris yang sebenarnya tidak diizinkan skema.
Hasilnya, 322 tes lulus dengan strict mode menyala dan tanpa mode yang dikecualikan. Commit itu juga mencatat satu temuan untuk ditindaklanjuti terpisah: satu kolom ada di migration tapi tidak ada di database live, jadi migrate:fresh dan produksi sudah tidak sama.
Mereproduksi dan menyalakan strict mode
Demo memakai Laravel 12 dan MySQL 8.0. Tabelnya sederhana: nama maksimal 20 karakter dan kolom tahun.
Schema::create('buildings', function (Blueprint $table) {
$table->id();
$table->string('name', 20);
$table->year('construction_year')->nullable();
});
Langkah 1: reproduksi kebocorannya
Tiru method dashboard lama di koneksi yang sama, lalu jalankan dua insert yang seharusnya ditolak:
$db->statement("SET sql_mode=''");
$db->select('select name, max(id) as id from buildings group by construction_year');
$db->statement("SET sql_mode='only_full_group_by'"); // terlihat seperti "mengembalikan"
$db->statement("insert into buildings (name) values ('Gedung Serbaguna Kecamatan Utara')");
$db->statement("insert into buildings (name, construction_year) values ('Balai Warga', '')");

Mode koneksi berubah dari daftar lengkap menjadi hanya ONLY_FULL_GROUP_BY. Nama terpotong, tahun kosong menjadi 0000, dan yang tersisa hanya satu warning yang tidak dibaca siapa pun.
Langkah 2: lihat hasil yang seharusnya
Dengan koneksi bawaan Laravel ('strict' => true) dan tanpa SET sql_mode, dua insert yang sama ditolak:

Ditolak memang terasa lebih merepotkan. Tapi error yang terlihat bisa diperbaiki hari itu juga, sedangkan data yang berubah diam-diam baru ketahuan bertahun-tahun kemudian.
Langkah 3: cek setelan strict di config
// config/database.php
'mysql' => [
// ...
'strict' => true, // bawaan Laravel; jangan dimatikan untuk menambal satu query
],
Dengan 'strict' => false, hasilnya sama persis dengan kebocoran di langkah 1, untuk seluruh aplikasi:

Langkah 4: cari semua SET sql_mode di kode
grep -rn "sql_mode" app/ config/ database/ routes/
Untuk setiap hasil, tanyakan: query apa yang dilindungi, dan apakah query itu masih dipakai? Kalau query grouping memang dibutuhkan, perbaiki query-nya. Pilih kolom yang ada di GROUP BY, atau bungkus kolom lain dengan fungsi agregat seperti MAX() atau ANY_VALUE(). Jangan matikan mode untuk seluruh koneksi.
Langkah 5: nyalakan strict, lalu biarkan tes yang bicara
Ubah strict menjadi true dan jalankan seluruh test suite di MySQL, bukan SQLite, karena SQLite tidak punya sql_mode. Setiap tes yang gagal menunjukkan satu tempat yang selama ini ditambal diam-diam oleh MySQL. Perbaiki penyebabnya, misalnya beri default di model atau perbaiki fixture. Jangan menambah pengecualian mode.
Langkah 6: pasang tes penjaga
Supaya setelan ini tidak dimatikan lagi diam-diam, tulis tes yang memeriksa config dan mode koneksi yang benar-benar aktif:
public function test_the_connection_runs_in_strict_mode(): void
{
$this->assertTrue(config('database.connections.mysql.strict'));
$mode = DB::selectOne('SELECT @@SESSION.sql_mode AS mode')->mode;
foreach (['STRICT_TRANS_TABLES', 'NO_ZERO_DATE', 'ONLY_FULL_GROUP_BY'] as $expected) {
$this->assertStringContainsString($expected, $mode);
}
}
public function test_oversized_text_is_refused_instead_of_truncated(): void
{
$this->expectException(\Illuminate\Database\QueryException::class);
DB::table('roles')->insert([
'name' => str_repeat('x', 300),
'display_name' => 'Terlalu Panjang',
'guard_name' => 'web',
]);
}
Langkah 7: periksa data lama
Menyalakan strict mode mencegah kerusakan baru, tapi tidak memperbaiki data yang sudah berubah. Cari jejaknya:
SELECT COUNT(*) FROM buildings WHERE construction_year = 0;
SELECT COUNT(*) FROM buildings WHERE CHAR_LENGTH(name) = 20; -- kandidat yang terpotong
Hasil query kedua hanya kandidat, karena nama yang memang tepat 20 karakter juga ikut terhitung. Untuk data yang sudah terpotong, nilai aslinya tidak bisa dipulihkan dari database. Satu-satunya sumber adalah backup lama atau orang yang menginputnya.
Checklist strict mode
'strict' => truediconfig/database.phpuntuk koneksi MySQL.- Tidak ada
SET sql_modedi kode aplikasi. - Query yang ditolak
ONLY_FULL_GROUP_BYdiperbaiki query-nya, bukan modenya. - Test suite dijalankan di MySQL, bukan hanya SQLite.
- Ada tes yang memeriksa config
strictdan@@SESSION.sql_mode. - Data lama sudah dicek untuk nilai nol dan teks terpotong.
- Alasan setiap pengecualian, kalau memang ada, ditulis di komentar config.
Risiko menyalakan strict di aplikasi lama
- Demo memakai MySQL 8.0 lokal. Daftar mode bawaan dan pesan error bisa sedikit berbeda di MariaDB atau versi MySQL lain.
- Contoh tabel dan query disederhanakan. Di proyek klien, query dashboard memakai grouping empat kolom dengan tiga subquery, dan kolom tahun ada di tabel proyek. Mekanismenya sama.
- Data yang sudah terpotong tidak bisa dipulihkan dari database. Artikel ini tidak membahas berapa banyak data di proyek itu yang terdampak. Yang tercatat di commit hanya contoh tahun yang menjadi
0000. - Menyalakan strict di aplikasi lama bisa memunculkan error di produksi. Jalankan seluruh tes dan uji alur utama di staging dulu. Error yang muncul setelah dinyalakan adalah data yang dulu diubah diam-diam.
SELECT @@SESSION.sql_mode dari dalam aplikasi menjawabnya dalam beberapa detik. Kalau yang keluar hanya NO_ENGINE_SUBSTITUTION, setiap insert hari ini bisa sedang mengubah data tanpa ada yang tahu.
Artikel terkait
Tulisan lain yang nyambung dengan topik ini.


Nomor Urut Kembar di Laravel: Kenapa Rule::unique Tidak Cukup dan Cara Membuatnya Aman dengan lockForUpdate
Dua pengguna mendapat nomor urut yang sama walaupun sudah ada Rule::unique dan unique index. Penyebabnya, demo MySQL, dan perbaikan dengan transaksi dan lockForUpdate.


Job Laravel Gagal Sebelum handle() Jalan, dan Retry Tidak Akan Menolong
Payload job Laravel yang membawa objek jadi bisa gagal sebelum handle() jalan, dan retry tidak menolong. Penyebab, demo, dan cara memperbaikinya langkah demi langkah.


Status "Dalam Proses" yang Tidak Pernah Selesai: Tiga Cara Job Laravel Gagal Tanpa Memberi Tahu Siapa Pun
Error di dalam catch, kehabisan memori, dan worker yang masih memakai kode lama. Tiga cara job Laravel gagal diam-diam, dengan demo dan perbaikannya.
Comments
Komentar akan tampil setelah disetujui.