Next.js에서 SQLite 사용할 때 주의할 것

SQLite는 혼자 개발할 때는 편하지만

SQLite는 설정이 간단해서 혼자 개발할 때는 편하다. 하지만 배포하면 문제가 생길 수 있다. 혼자 개발할수록 확인한 값과 바꾼 값을 따로 남기는 습관이 필요하다.

왜 헷갈릴까

Next.js에서 SQLite를 쓸 때 혼동하기 쉬운 부분이 있다. 로컬 개발 환경과 배포 환경에서 파일 경로가 다를 수 있고, 웹 렌더링 때와 API 라우트에서 동작이 다를 수도 있다.

확인해야 할 것들

배포된 사이트가 제대로 보이는지 먼저 확인한다.

curl -s https://example.com | grep -Ei 'title|description|canonical|og:|twitter:'
npm run build

HTML head 부분에서 제목, 설명, canonical 링크, Open Graph 정보, Twitter 카드 정보가 제대로 나오는지 봐야 한다. 이걸 통해 메타데이터가 정상인지 알 수 있다.

빌드 로그도 중요하다

코드를 수정한 후 빌드할 때 경고나 에러가 있는지 확인한다. 에러가 있으면 그게 SQLite 문제의 원인일 수 있다.

확인 체크리스트

1. 같은 조건에서 문제가 다시 나오는지 확인한다
2. 로그와 HTML 응답에서 뭐가 달라졌는지 확인한다
3. 공개 사이트, 빌드 결과, 로컬 환경을 비교한다

작은 변경이 모든 걸 바꿀 수 있다

한 번에 여러 설정을 바꾸지 않는 것만으로도 원인 추적이 훨씬 쉬워진다. 한 가지씩만 바꾸고 동작을 확인하자.