Cara memperbaiki Modul tidak ditemukan: Tidak dapat menyelesaikan masalah saat menerapkan nextjs tetapi tidak secara lokal

Men-deploy aplikasi Next.js ke platform hosting seperti Railway seringkali menjadi tantangan, terutama ketika semuanya berjalan lancar secara lokal tetapi tiba-tiba muncul error saat proses build di server. Salah satu masalah umum adalah kesalahan “Modul Tidak Ditemukan: Tidak Dapat Diselesaikan”yang disebabkan oleh perbedaan peka huruf besar-kecil dalam nama file atau folder.

Pada artikel kali ini saya akan berbagi pengalaman saya dalam mengatasi error tersebut, lengkap dengan langkah solusi yang bisa Anda coba.

Masalah yang saya hadapi

Beberapa waktu lalu, saya mencobanya menyebarkan Proyek Next.js ke Kereta Api. Secara lokal, proyek ini berjalan tanpa masalah. Namun, selama proses tersebut membangun di Kereta Apimuncul error seperti ini:

Module not found: Can't resolve 'path/to/FileName'

Awalnya, saya bingung karena secara lokal semuanya tampak baik-baik saja. Saya pun mencoba googling untuk mencari solusinya, namun tidak ada jawaban spesifik untuk masalah ini. Setelah beberapa waktu frustrasi, saya menemukan diskusi tentang forum Kereta Api yang memberikan titik terang.

Penyebab Masalah

Masalah ini disebabkan oleh perbedaan peka huruf besar-kecil antara nama file atau folder secara lokal dan yang terdeteksi oleh sistem di server. Misalnya:

• Di lokal: FileName.js
• Di server: filename.js

Sistem operasi seperti macOS atau Windows biasanya tidak mempedulikan sensitivitas huruf besar-kecil pada nama file atau folder. Namun, server Linux digunakan oleh platform hosting seperti Railway Perhatikan sensitivitas huruf besar-kecil. Akibatnya, file dengan nama yang tidak konsisten menjadi tidak terdeteksi selama pembuatan.

Solusi yang Saya Temukan

Untuk mengatasi masalah ini, Anda perlu mengatur Git untuk mendeteksi perubahan pada file atau folder berdasarkan peka huruf besar-kecil. Berikut langkah-langkahnya:

1. Periksa perbedaan peka huruf besar-kecil di Git:

Git secara default mengabaikan perubahan peka huruf besar-kecil. Untuk mengubahnya, jalankan perintah berikut di terminal:

git config core.ignorecase false

2. Identifikasi file yang bermasalah:

Setelah menjalankan perintah di atas, Git akan mulai mendeteksi perubahan pada file atau folder yang hanya berbeda huruf besar dan kecil. Jalankan perintah berikut untuk melihat daftar perubahan:

git status

3. Perbaiki nama file atau folder (Jika perlu)

Pastikan nama file atau folder secara lokal sesuai dengan yang seharusnya, sesuai dengan sensitivitas huruf besar/kecil yang benar.

4. Melakukan dan mendorong perubahan:

Setelah nama file diperbaiki, komit perubahan ke repositori Git dan kirim ke server:

git add . git commit -m "Fix case sensitive file names" git push

5. Membangun kembali proyek:

Terapkan ulang proyek Anda ke Kereta Api atau platform lainnya. Jika langkah-langkah di atas dilakukan dengan benar, kesalahan “Modul Tidak Ditemukan: Tidak Dapat Diselesaikan” seharusnya terselesaikan.

Hasil akhir

Setelah saya mengikuti langkah-langkah di atas, error tersebut berhasil diatasi dan aplikasi saya dapat di-deploy tanpa masalah. Pembangunan selesai dengan lancar, dan aplikasi dapat diakses sebagaimana mestinya.

Kesimpulan

Masalah seperti ini mungkin tidak hanya terjadi pada Railway saja, namun juga pada platform hosting lain yang menggunakan server Linux. Oleh karena itu, penting untuk memastikan nama file atau folder konsisten dengan sensitivitas huruf yang benar.

Dengan menjalankan perintah sederhana seperti git config core.ignorecase falseAnda dapat menghindari kebingungan dan memperbaiki kesalahan yang disebabkan oleh perbedaan peka huruf besar-kecil.

Semoga artikel ini bermanfaat dan membantu anda yang mengalami permasalahan serupa. Jika Anda memiliki pertanyaan atau pengalaman lain, silakan bagikan di komentar!