Nodemon hilang setelah deploy karena npm sengaja melewatkan devDependencies saat NODE_ENV=production aktif. Perintah seperti npm ci --omit=dev atau npm install --production hanya memasang dependencies. Solusinya pasang ulang tanpa flag omit, lalu pastikan nodemon memang tercatat di devDependencies.
Penyebab DevDependency Tidak Terinstall di Node.js
npm versi baru otomatis memangkas dev saat mode production aktif. Platform deploy seperti VPS, Docker, atau PaaS sering menyetel NODE_ENV=production secara default.
NODE_ENV=productionmembuat npm mengabaikandevDependencies.- Flag
--omit=devdan--productionpunya efek yang sama. npm cimenghapusnode_moduleslalu install ulang sesuai lockfile, sehingga dev yang sebelumnya ada bisa hilang.package.jsonsalah menaruh paket, ataupackage-lock.jsontidak ikut di-commit, membuat hasil install di server berbeda.
Cek log deploy dahulu. Cari baris berisi omit dev, production mode, atau added X packages, removed Y packages.
| Masalah | Penyebab | Solusi |
|---|---|---|
| Nodemon hilang setelah deploy | Install jalan dengan --omit=dev |
Install ulang dengan --include=dev |
npm ci hanya pasang dependencies |
NODE_ENV=production aktif |
Set NODE_ENV=development saat build |
| Script dev gagal jalan | Nodemon tidak ada di package.json |
Tambahkan ke devDependencies |
Cara Memperbaiki DevDependency Tidak Terinstall
Ikut urutan ini agar diagnosis tidak menebak-nebak:
- Periksa
package.json. Pastikannodemonada didevDependencies, bukan hanya terpasang global di laptop. - Cek environment server. Jalankan perintah cek
NODE_ENVsebelum install ulang. - Install ulang tanpa pemangkasan dev. Gunakan
npm ci --include=devbila lockfile tersedia. - Verifikasi paket dengan
npm ls nodemon. Perintah harus menampilkan versi, bukan pesanextraneousatau kosong.
echo $NODE_ENV
npm install
npm ci --include=dev
npm ls nodemon
Jangan langsung memakai --legacy-peer-deps, menghapus package-lock.json, atau menghapus node_modules sebagai langkah pertama. Ketiganya menyembunyikan konflik versi dan bisa membuat deploy berikutnya tidak konsisten. Pakai hanya setelah pesan error menunjukkan konflik peer dependency atau file corrupt.
FAQ
Kenapa npm install tidak memasang devDependencies di server?
Karena server berjalan dengan NODE_ENV=production atau perintah install memakai --omit=dev.
Apakah devDependencies dibutuhkan saat production berjalan?
Tidak untuk runtime, nodemon idealnya hanya dipakai development dan production memakai node atau process manager.
Bagaimana install devDependencies tanpa merusak package-lock.json?
Gunakan npm ci --include=dev agar install tetap mengikuti lockfile tanpa mengubah rentang versi.