turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
개인 프로젝트에서 네트워크 오류를 안전하게 처리하기
로컬에서는 잘 동작하던 네트워크 요청이 배포 환경에서 실패한다면, CORS와 환경변수부터 차례대로 확인해야 한다.
Rate limit 설정으로 사용자 입력 이상을 줄이기
대량 요청이 들어올 때 rate limit이 제대로 작동하지 않으면 시스템에 부하가 걸린다. 배포 전 확인할 체크리스트.
계속 읽기 →Next.js에서 메타데이터 로그를 보고 SEO 문제를 진단하기
운영 중에는 작은 이상 신호도 빨리 분리해서 봐야 한다. Record 타입의 메타데이터가 제대로 렌더되는지 확인하는 방법.
계속 읽기 →React에서 key prop 문제로 폼 입력이 불편할 때
폼 입력이 이상하거나 리스트 아이템이 엉키는 문제는 대부분 key prop과 related. 재현 조건을 먼저 잡으면 빠르게 해결된다.
계속 읽기 →React에서 큰 컴포넌트를 안전하게 분리하는 방법
컴포넌트가 커질수록 한 번에 정답을 맞히기는 어렵다. 작은 단위로 분리하면서 렌더링 조건과 이벤트를 점검하는 실전 과정.
계속 읽기 →React 상태 관리 배포 전 확인 체크리스트
로컬 개발에서 완벽했던 상태 관리가 배포 환경에서 깨지는 경우, 이벤트 흐름과 렌더링 조건을 체계적으로 검증하는 방법.
계속 읽기 →서버 배포 환경에서만 터지는 연결 문제 디버깅하기
로컬에서는 잘 동작하던 배포가 서버에서만 실패하는 경우, 포트 확인부터 권한까지 단계적으로 진단하는 방법.
계속 읽기 →서버 환경변수가 안 먹을 때 배포 전 확인
로그 확인 중 환경변수가 적용이 안 되었을 때, 서버 운영 관점에서 원인을 찾는 체계적인 방법.
계속 읽기 →제네릭이 빌드에서만 에러 날 때 대처법
TypeScript 제네릭이 로컬에선 안 되고 빌드에서만 에러 날 때, 빠르게 찾아내는 방법.
계속 읽기 →DB 데이터 삭제할 때 배포 전 점검법
데이터 삭제 작업을 배포 전에 안전하게 검증하는 체계적인 방법과 확인 순서.
계속 읽기 →SQLite 마이그레이션할 때 안전하게 하는 방법
SQLite를 운영 환경에서 다룰 때, 데이터 손실 없이 스키마를 변경하는 체계적인 방법.
계속 읽기 →Prisma 타입 체크리스트: 배포 전에 확인할 것
TypeScript와 Prisma를 쓸 때 놓치기 쉬운 타입 문제를 배포 전에 미리 잡는 방법.
계속 읽기 →Docker 이미지 용량이 터질 때 줄이는 법
Docker 이미지 용량이 커서 배포가 막힐 때, 원인을 찾고 빠르게 해결하는 방법.
계속 읽기 →Docker 이미지 로딩이 느릴 때 디버깅
Docker 컨테이너 배포 후 이미지가 느리게 로드될 때, 체계적으로 원인을 찾는 방법.
계속 읽기 →API 응답이 권한 문제일 때 확인법
권한 API가 응답을 안 할 때, 요청과 응답을 체계적으로 확인하는 실전 가이드.
계속 읽기 →Next.js 배포 후 환경변수가 안 먹을 때
Next.js에서 환경변수 설정이 로컬에선 잘 작동하는데 배포 후 안 먹을 때 확인할 사항들.
계속 읽기 →Docker 이미지 태그로 헷갈렸을 때 확인 순서
Docker 컨테이너가 이상할 때, 로그와 응답을 보며 원인을 체계적으로 찾는 실전법.
계속 읽기 →배포 후 DB가 응답 안 할 때 확인 방법
로컬에선 정상이던 DB 설정이 배포 환경에서 먹지 않을 때, 체계적으로 원인을 찾는 방법.
계속 읽기 →동적 라우트 배포 전 점검 체크리스트
배포 전에 동적 라우트가 정상 작동하는지 빠르게 확인하는 실전 방법들을 정리했다.
계속 읽기 →sitemap.xml이 크롤러에게 제대로 읽히지 않을 때
sitemap.xml이 생성되긴 했지만 검색 엔진 크롤러가 페이지를 수집하지 못할 때의 진단 방법.
계속 읽기 →배포 후 페이지네이션 데이터가 안 나올 때
페이지네이션이 있는 페이지를 배포한 후 특정 페이지에서 데이터가 보이지 않을 때의 해결 방법.
계속 읽기 →useEffect 훅이 예상과 다르게 작동할 때
React에서 useEffect 훅이 무한 루프를 만들거나 제때 실행되지 않을 때의 진단 방법.
계속 읽기 →API 요청 목록이 느려질 때
페이지네이션된 API 목록 조회가 느려질 때 validation 레이어의 성능 문제를 진단하는 방법.
계속 읽기 →Next.js에서 canonical URL이 제대로 안 나올 때
SEO를 위한 canonical 태그가 Next.js에서 정상 생성되지 않을 때의 해결 방법.
계속 읽기 →