ERR_MODULE_NOT_FOUND는 tsconfig보다 빌드된 import 경로를 먼저 봅니다

Node.js ESM 전환 후 ERR_MODULE_NOT_FOUND가 날 때 dist 파일의 import specifier를 먼저 확인하는 메모.

Node.js에서 ESM으로 바꾼 뒤 ERR_MODULE_NOT_FOUND가 나면 tsconfig를 계속 바꾸기 전에 dist에 나온 import 경로를 먼저 봅니다. 런타임은 TypeScript 원본이 아니라 빌드된 파일을 실행하니까, ./client가 실제로 ./client.js인지, 상대 경로가 dist 기준으로 맞는지, package.json의 type과 exports가 막고 있는지 확인해야 합니다. 로컬에서는 대소문자 차이가 안 보이다가 CI에서만 터지는 경우도 많았습니다.