turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
Next.js 배포 전에 SEO 메타데이터 확인하기
Next.js 사이트를 배포하기 전에 메타데이터와 SEO 관련 설정을 확인하는 방법입니다.
헬스 체크 실패할 때 안전하게 대응하는 방법
웹 애플리케이션의 헬스 체크 엔드포인트 문제를 해결하는 방법입니다.
계속 읽기 →HTTPS 인증서 문제로 막힐 때 확인하는 법
Nginx와 도메인 설정에서 HTTPS 인증서 문제를 해결하는 방법입니다.
계속 읽기 →배포 전에 꼭 확인해야 할 빌드와 서버 상태
서버 배포 시 빌드 로그와 서버 리소스를 체계적으로 확인하는 방법입니다.
계속 읽기 →목록 렌더링이 느려졌을 때 해야 할 일
아이템이 많은 목록을 렌더링할 때 성능 문제를 찾는 방법입니다.
계속 읽기 →Next.js에서 SQLite 사용할 때 주의할 것
Next.js와 SQLite를 함께 쓸 때 생기는 문제들과 확인 방법입니다.
계속 읽기 →배포 전 데이터베이스 마이그레이션 확인하기
Prisma로 데이터베이스 마이그레이션을 할 때 배포 전에 확인해야 할 것들입니다.
계속 읽기 →웹 리스트 성능이 떨어질 때 찾아야 할 것
리스트를 보여주는 페이지가 느려졌을 때 원인을 빠르게 찾는 방법입니다.
계속 읽기 →배포 후 데이터 문제가 생겼을 때 확인하는 법
웹 개발에서 배포 후 데이터 손실이나 변경 같은 문제를 추적하는 방법입니다.
계속 읽기 →React 모달 컴포넌트 버그 디버깅하기
React에서 모달이나 팝업 같은 동작 문제를 체계적으로 찾는 방법입니다.
계속 읽기 →웹 개발 버그 확인할 때 처음 봐야 할 것들
웹 개발에서 로컬과 운영 환경이 다를 때 체계적으로 확인하는 순서를 정리했습니다.
계속 읽기 →Docker 컨테이너 환경변수 문제 디버깅
Docker로 개발할 때 환경변수 때문에 생기는 문제를 빠르게 찾는 방법을 정리했습니다.
계속 읽기 →데이터베이스 관계 설정이 꼬였을 때
Prisma에서 관계를 정의했는데 실제 쿼리에서 데이터가 제대로 연결되지 않는다. 관계 설정과 마이그레이션을 확인하는 방법을 정리했다.
계속 읽기 →docker-compose 빌드가 자꾸 느려질 때
프로젝트가 커지면서 docker-compose up이 점점 오래 걸린다. 빌드 시간을 줄이려면 어떤 부분을 확인하고 개선해야 할까.
계속 읽기 →TypeScript에서 Prisma 타입을 다룰 때 실수하기 쉬운 부분
Prisma 타입이 TypeScript에서 제대로 인식되지 않으면 타입 체크를 통과해도 런타임에 에러가 생긴다. 타입 안정성을 확보하는 방법을 정리했다.
계속 읽기 →Docker 이미지 로딩이 에뮬레이터와 실기기에서 다를 때
로컬 에뮬레이터에서는 잘 로드되는 이미지가 실제 배포 후 로드되지 않는다. Docker 이미지와 컨테이너 설정을 확인하는 방법을 정리했다.
계속 읽기 →배포 전에 Prisma 마이그레이션 상태 확인하기
배포 전 Prisma 마이그레이션이 제대로 적용됐는지 확인하지 않으면, 배포 후 데이터베이스 에러가 터진다. 안전한 확인 순서를 정리했다.
계속 읽기 →Next.js 동적 라우트 배포 후 화면이 다르게 보일 때
로컬 개발 환경에서는 멀쩡한 동적 라우트가 배포 후 다르게 보인다. 문제를 크게 잡지 말고 작은 부분부터 확인하는 방법을 정리했다.
계속 읽기 →날짜 컬럼 마이그레이션이 깨졌을 때 복구하기
Prisma 마이그레이션 중 날짜 컬럼 타입을 바꿨는데 배포 후 데이터가 손상되었다. 안전하게 복구하고 마이그레이션을 다시 적용하는 방법을 정리했다.
계속 읽기 →데이터베이스 unique 제약 때문에 에러가 날 때
마이그레이션 후 unique 제약이 걸려서 데이터 추가가 실패한다. 원본 데이터를 검사하고 제약을 적용하는 안전한 순서를 정리했다.
계속 읽기 →빌드 로그 페이지를 관리자에 붙일 때 실수하기 쉬운 부분
관리자 페이지에서 빌드 로그를 볼 수 있게 만들었는데, 로컬과 배포 환경에서 다르게 동작한다. 이때 어떤 순서로 확인해야 하는지 정리했다.
계속 읽기 →Docker 컨테이너 용량 확인하고 최적화하기
Docker 이미지가 자꾸 커지다가 어느 날 갑자기 배포가 느려지거나 실패한다. 컨테이너 상태를 확인하고 용량을 줄이는 방법을 정리했다.
계속 읽기 →서버에서만 연결이 안 될 때 확인 순서
로컬에서는 멀쩡한데 배포한 서버에서만 문제가 생기는 경우가 있다. 보통 방화벽이나 포트 매핑이 원인인데, 빨리 찾으려면 어떤 순서로 확인해야 할까.
계속 읽기 →웹 개발에서 날짜 필터 구현할 때 놓치는 부분
관리자 페이지의 날짜 필터를 만들다 보면 로컬과 배포 환경에서 다르게 동작하는 경우가 많다. 이때 어떤 순서로 확인해야 원인을 빨리 찾을 수 있는지 정리했다.
계속 읽기 →