turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
서버에서만 실패하는 빌드 문제 디버깅하기
로컬에서는 정상인데 운영 서버에서만 빌드가 실패하거나 앱이 터질 때. 환경 변수, 프로세스, 로그를 순서대로 확인해야 한다.
리스트 성능이 떨어질 때 확인하는 순서
페이지네이션, 권한, 팝업 등 리스트 기능이 갑자기 느려지거나 이상할 때. 운영 중에는 작은 신호도 빨리 분리해서 봐야 한다.
계속 읽기 →DB 유니크 제약 조건 변경할 때 피해야 할 실수
Unique 제약을 추가하거나 변경할 때 스키마부터 백업까지 체크리스트. 한 번에 여러 설정을 바꾸지 않는 것이 핵심이다.
계속 읽기 →Prisma 마이그레이션 문제 디버깅하는 법
DB 마이그레이션 중 타입이나 스키마 문제가 생겼을 때. 스키마 검증, 환경 설정, 마이그레이션 상태를 순서대로 확인해야 한다.
계속 읽기 →검색 입력이 꼬였을 때 안전하게 디버깅하기
React 검색 UI의 상태 버그를 좁혀내는 순서. 재현 조건부터 렌더링, 이벤트 흐름까지 단계적으로 확인해야 실수를 줄일 수 있다.
계속 읽기 →API 파일 업로드 기능이 안 될 때 처음 볼 로그
Next.js에서 파일 업로드 기능을 디버깅할 때 가장 먼저 확인해야 할 로그와 설정을 정리했습니다.
계속 읽기 →Docker 이미지 태그 배포가 실패했을 때
Docker 배포에서 이미지 버전 문제를 진단하고 빠르게 수정하는 방법을 정리했습니다.
계속 읽기 →데이터베이스 백업 실패의 원인을 빨리 찾는 방법
백업 스크립트가 실패했을 때 단계별로 원인을 좁혀서 찾는 순서를 정리했습니다.
계속 읽기 →배포 후 서비스가 뜨지 않을 때 확인 순서
웹 배포 후 예상치 못한 문제를 빠르게 진단하고 해결하는 방법을 정리했습니다.
계속 읽기 →데이터베이스를 백업해야 할 때를 판단하는 기준
서버 운영 중 언제 DB 백업이 필요한지, 그리고 어떻게 확인할지 정리했습니다.
계속 읽기 →Nginx 리버스 프록시 설정 후 트래픽이 안 통할 때
Nginx에서 프록시 규칙을 설정했는데 요청이 제대로 전달되지 않을 때의 확인 순서를 정리했습니다.
계속 읽기 →서버 헬스 체크가 실패할 때 빨리 확인하는 방법
서버 운영 중 헬스 체크 문제를 단계별로 진단하는 순서를 정리했습니다.
계속 읽기 →React 컴포넌트가 자꾸 리렌더링될 때 확인 순서
React에서 불필요한 리렌더링이 생기는 원인을 빠르게 파악하고 수정하는 방법을 정리했습니다.
계속 읽기 →canonical URL 문제로 페이지 속도가 느려졌을 때
Next.js에서 메타데이터 설정 문제가 야기하는 성능 저하를 진단하는 방법을 정리했습니다.
계속 읽기 →Docker 컨테이너 재시작 후 문제가 생길 때 확인할 것
Docker 컨테이너 작업에서 예상치 못한 문제를 빨리 파악하는 확인 순서를 정리했습니다.
계속 읽기 →Nginx 설정에서 HTTPS 인증서 오류를 빨리 찾는 방법
도메인이나 Nginx 설정 문제로 인증서 오류가 날 때 확인할 순서를 정리했습니다.
계속 읽기 →Next.js Route Handler가 검색에 노출되지 않을 때
Next.js에서 Route Handler 문제를 디버깅할 때 확인할 순서와 판단 기준을 정리했습니다.
계속 읽기 →Flutter 앱에서 API 연동 후 배포했을 때 확인할 것
Flutter 앱의 API 문제는 에러 메시지부터 확인해서, 인증 상태와 요청/응답을 체계적으로 검토하면 대부분의 문제를 빠르게 해결할 수 있다.
계속 읽기 →HTTPS 인증서 갱신 후 배포했을 때 확인 사항
HTTPS 인증서 갱신은 민감한 작업인데, DNS 응답부터 시작해서 실제 SSL 인증서 상태까지 단계적으로 확인하면 문제를 빠르게 찾을 수 있다.
계속 읽기 →로컬과 서버에서 네트워크 응답이 다를 때
로컬과 운영 환경의 네트워크 동작이 다르면 포트, 디스크, 권한을 체계적으로 확인해서 환경 차이를 명확히 하면 해결할 수 있다.
계속 읽기 →Next.js 정적 생성(SSG) 후 페이지 속도가 느려졌을 때
SSG 페이지의 성능 저하는 HTML head의 메타데이터부터 확인해서, 빌드 로그와 실제 응답을 비교하면 원인을 좁힐 수 있다.
계속 읽기 →데이터베이스 마이그레이션 후 배포했을 때 확인 사항
DB 마이그레이션은 신중하게 진행해야 하는데, 현재 상태를 파악하고 각 단계를 명확히 기록하면 문제 발생 시 빠르게 대응할 수 있다.
계속 읽기 →React 상태 관리를 변경할 때 배포 전 확인할 것
상태 관리 로직을 변경한 후 배포하기 전에 로컬과 운영 환경의 동작을 충분히 확인하면 배포 후 문제를 크게 줄일 수 있다.
계속 읽기 →서버에서만 에러가 나는 문제를 찾는 법
서버에서만 문제가 발생하면 로컬과 운영 환경의 상태를 정확히 비교해서 차이점을 찾는 것이 가장 효율적이다.
계속 읽기 →