turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
502 에러가 났을 때 먼저 볼 로그
개인 프로젝트에서 갑자기 502 에러가 나면 처음부터 정답을 맞히려고 하지 말고 체계적으로 문제를 좁혀가야 한다.
패키지 충돌로 사용자 입력이 막힐 때
운영 중에는 작은 이상 신호도 빨리 분리해서 봐야 한다. 패키지 문제일 수도, 설정 문제일 수도, 사용자의 입력 흐름 문제일 수도 있다.
계속 읽기 →배포 전에 컨테이너 상태 확인하기
Docker 컨테이너 재시작 문제는 검색으로 찾은 해결책을 바로 적용하기보다 먼저 현재 상태를 정확히 파악하는 게 빠르다.
계속 읽기 →로딩 상태가 화면에 늦게 나타날 때
React에서 로딩 표시 지연 문제는 대부분 state 업데이트 흐름의 타이밍 차이다. 로컬과 배포 환경의 속도 차이를 고려해야 한다.
계속 읽기 →검색 결과를 따라 했을 때 실수 줄이기
스택오버플로우나 커뮤니티에서 찾은 코드를 바로 쓰면 context 차이로 문제가 생긴다. 재현 조건을 먼저 확인하면 불필요한 시행착오를 줄일 수 있다.
계속 읽기 →RSS 피드에 관리자 페이지를 붙일 때
Next.js에서 RSS 설정을 할 때는 브라우저 화면만 보지 말고 빌드 로그와 실제 응답을 함께 확인해야 한다.
계속 읽기 →정렬 기준을 안전하게 바꾸려면
운영 환경에서 데이터 정렬 방식을 바꿀 땐 로컬과 배포 환경의 차이를 먼저 확인해야 한다.
계속 읽기 →검색으로 찾은 해결책이 자기 환경에서 안 될 때
Stack Overflow나 블로그에서 찾은 해결책을 따라 했는데 안 될 때 디버깅하는 방법입니다.
계속 읽기 →API 응답이 갑자기 느려질 때: 원인 좁히기
API가 느려졌을 때 요청과 응답을 분석해서 병목을 찾는 방법입니다.
계속 읽기 →서버가 자꾸 재부팅될 때: 로그로 원인 찾기
서버가 예상 없이 재부팅될 때 로그를 보고 원인을 좁히는 방법입니다.
계속 읽기 →React 폼 입력 문제: 사용자가 데이터를 입력할 수 없을 때
폼 입력이 제대로 동작하지 않을 때 React에서 원인을 찾는 방법입니다.
계속 읽기 →TypeScript 타입 단언이 늘어날 때 점검하기
TypeScript에서 타입 단언(as)이 자꾸 늘어날 때 근본 원인을 찾는 방법입니다.
계속 읽기 →React 상태 초기화: 컴포넌트 리렌더링이 예상과 다를 때
React 상태 관리에서 컴포넌트가 예상과 다르게 업데이트될 때 디버깅하는 방법입니다.
계속 읽기 →Nginx 설정이 배포 환경에서 막힐 때
로컬에서는 잘 도는데 Nginx 리버스 프록시 때문에 배포 환경에서 안 될 때의 해결 방법입니다.
계속 읽기 →혼자 개발할 때 접근성 문제 디버깅하기
웹 페이지의 접근성 문제를 디버깅할 때 확인해야 할 순서를 정리했습니다.
계속 읽기 →Docker Node 이미지 디버깅: 컨테이너가 계속 죽을 때
Docker 컨테이너의 Node 애플리케이션이 자꾸 떨어질 때 로그를 보는 순서를 정리했습니다.
계속 읽기 →Next.js seed 데이터 문제: 검색엔진 크롤러가 보는 페이지
검색 결과에서만 페이지가 이상하게 보일 때 seed 데이터 문제를 디버깅하는 방법입니다.
계속 읽기 →혼자 개발할 때 놓치기 쉬운 권한 설정
혼자 개발하면서 실수하기 쉬운 권한 문제를 확인하는 순서를 정리했습니다.
계속 읽기 →Next.js 메타데이터 문제: 모바일에서 공유 이미지가 안 보일 때
Next.js 페이지의 OG 태그와 메타데이터를 디버깅하는 실전 방법을 정리했습니다.
계속 읽기 →TypeScript 설정 객체를 다룰 때 타입 에러 좁혀나가기
optional 필드, null 체크, 타입 가드를 단계적으로 정의해서 설정 객체의 타입을 명확하게 만드는 방법.
계속 읽기 →배포 후 데이터가 사라졌을 때 확인하는 순서
환경변수 설정 차이로 인해 데이터베이스 연결이 달라질 수 있다. 로컬과 운영의 데이터 저장소가 다를 때 문제를 진단하는 방법.
계속 읽기 →서비스가 간헐적으로 느릴 때 먼저 봐야 할 로그
사용자가 느린 응답을 보고 있을 때, 서버 로그부터 캐시까지 어떤 순서로 확인할지 정리했다.
계속 읽기 →배포 전에 확인해야 할 환경변수 체크리스트
페이지 속도가 느려지거나 기능이 동작하지 않는다면, 환경변수 설정이 빌드 시점과 런타임에 일치하는지 확인해야 한다.
계속 읽기 →서버에서만 터질 때 패키지 충돌과 권한 문제 찾기
로컬에서는 된다는데 서버에서만 안 된다. 권한, 포트, 프로세스를 한 번에 확인하는 진단 방법.
계속 읽기 →