問題:ファイルが存在するにもかかわらず Module not found
ある日、作業を完了して変更をマージしていたところ、
Vercelのデプロイが失敗しました。
Build Logs
Failed to compile.
./src/components/admin/AttendanceView/AttendanceTablePersonal.tsx
Module not found: Can't resolve '@/stores/admin/attendanceTablePersonalSlice'
ログを確認すると、Module not found エラーが発生し、
attendanceTablePersonalSlice が見つからないとのこと。
しかし、ファイルは確かに存在し、ローカル環境での npm run build ではエラーは出ません。
何が原因だったのでしょうか？
原因: ファイル名の大文字を小文字に変更した (Gitの設定とファイルシステムの大文字・小文字の扱い)
原因は、ファイル名の大文字を小文字を変更した際に、Gitがその変更を正しく検知していなかったことです。
これにより、削除されているファイルを参照したためエラーとなりました。
Gitが大文字と小文字を区別するかどうかは、WinやMacなど大抵のケースでは大文字小文字を区別せず、Linuxなどの一部環境ではデフォルトで区別しているようです。
以下Windowsの例となります。
PowerShell
mkdir git-case-test
cd git-case-test
git init
echo "sample" > Sample.txt
git add Sample.txt
git commit -m "Add Sample.txt"
例えば上記コマンドでリポジトリを作成し、Sample.txtをコミット。
PowerShell
mv Sample.txt sample.txt
git status
Sampleをsampleに変更し、git statusで確認しても
PowerShell
On branch master
nothing to commit, working tree clean
変更を検知していません。
PowerShell
git config core.ignorecase false
git status
そこで大文字小文字を区別するようにGitの設定を変更すると
PowerShell
On branch master
Changes not staged for commit:
(use "git add/rm <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
deleted: Sample.txt
Untracked files:
(use "git add <file>..." to include in what will be committed)
sample.txt
正しく検出することができました。
解決策1: Gitのオプションで大文字小文字を区別させる
git config core.ignorecase false
再現例の通り、上記コマンドによって大文字小文字を区別する方法です。
解決策2: ファイル名を一旦別名に変更してコミットする
今回のケースではファイル名を一時的に別名に変更してからコミットすることで対処しました。
理由としては先述のコマンドはローカルリポジトリでのみ有効となるため、
開発環境の差が生まれることを懸念したためです。
参考
Microsoft公式ドキュメント
Macユーザーの例