turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
폼 검증 규칙이 늘어날 때 실수 줄이는 법
검증 규칙이 컴포넌트 곳곳에 흩어지면 빠뜨리기 쉽다. 한곳에 모아두는 방식으로 바꾼 경험을 적었다.
React 상태 이름 변경 시 안전하게 마이그레이션하기
상태 이름이 바뀔 때 발생하는 문제들과 그 해결 방법을 정리했다.
계속 읽기 →React 폼 입력에서 예상치 못한 동작 디버깅하기
React 폼 컴포넌트가 의도대로 동작하지 않을 때 어디서부터 확인해야 하는지 정리했다.
계속 읽기 →Next.js SEO 메타데이터 확인하는 흐름
Next.js 프로젝트에서 SEO 문제를 디버깅할 때 확인해야 할 포인트를 정리했다.
계속 읽기 →앱 버전 충돌로 막힐 때 해결하기
앱 버전 문제로 기능이 작동하지 않을 때 원인을 찾고 해결하는 방법.
계속 읽기 →헬스체크 엔드포인트가 막힐 때 보는 체크리스트
헬스체크 응답이 느려지거나 실패할 때, 화면만 보면 원인을 놓치기 쉽다. 로그와 응답을 함께 보며 단계별로 원인을 좁혀가는 방법을 정리했다.
계속 읽기 →React 폼 입력 성능이 떨어질 때 원인 추적
React 폼 입력이 느려질 때 체계적으로 성능 문제를 찾고 해결하는 방법.
계속 읽기 →Next.js 배포 후 메타데이터 검증
배포 후 메타데이터, canonical URL, 빌드 로그를 확인해서 SEO 문제를 찾는 방법.
계속 읽기 →관계형 데이터 중복 문제 운영 점검
데이터베이스에서 관계형 데이터가 중복될 때 원인을 찾고 해결하는 방법.
계속 읽기 →Prisma 마이그레이션 서버 DB 접근 문제 해결
프로덕션 서버에서 Prisma가 데이터베이스에 접근하지 못할 때 원인을 찾는 방법.
계속 읽기 →Next.js Route Handler 배포 후 화면 차이 해결
Next.js 배포 후 라우트가 예상과 다르게 작동할 때 원인을 찾는 방법.
계속 읽기 →TypeScript optional 런타임 데이터 불일치 디버깅
TypeScript 타입 정의와 실제 런타임 데이터가 다를 때 효과적으로 추적하는 방법.
계속 읽기 →Rate limiting과 세션 문제 배포 전 확인
배포 전에 rate limiting 설정과 세션 관리를 점검하는 방법.
계속 읽기 →React 폼 타입이 엉킬 때 정확히 추적하기
React에서 폼 입력 타입 문제를 디버깅하는 체계적인 방법.
계속 읽기 →Docker compose 빌드가 느릴 때 확인할 것
Docker compose 빌드 시간이 오래 걸리는 원인을 효율적으로 찾아내는 방법.
계속 읽기 →데이터베이스 직접 수정 전 안전한 검증
프로덕션 DB에서 데이터를 수정해야 할 때 실수를 줄이는 체계적인 방법.
계속 읽기 →TypeScript optional 타입 추적하기
TypeScript에서 optional 타입을 디버깅할 때 체계적으로 추적하는 방법을 정리했다.
계속 읽기 →301 리다이렉트가 외부에서 안 될 때 체크하기
도메인과 Nginx 설정에서 301 리다이렉트가 작동하지 않을 때. 인증서, DNS, HTTP 상태 코드를 차례로 확인한다.
계속 읽기 →이미지 로딩이 환경마다 다를 때 체크리스트
에뮬레이터와 실제 기기, 로컬과 운영에서 이미지가 다르게 로드될 때. 볼륨 마운트, 포트 매핑, 컨테이너 상태를 순서대로 확인한다.
계속 읽기 →Next.js 서버에서만 오류가 날 때 로그 읽기
로컬에서는 정상이지만 운영 환경의 Next.js 서버에서만 실패할 때. 빌드 로그, sitemap/RSS, 헬스 체크를 확인해야 한다.
계속 읽기 →Next.js의 메타 데이터 설정 문제 디버깅
SEO 메타 태그, OG 태그, Canonical 링크가 제대로 렌더링되지 않을 때. 로컬과 운영의 차이를 확인해야 한다.
계속 읽기 →Docker 컨테이너 캐시 문제 해결하기
컨테이너 이미지 빌드가 이전 결과를 그대로 사용할 때. 환경 변수, 이미지 태그, 로그를 순서대로 확인한다.
계속 읽기 →API 권한 체크 로직을 안전하게 수정하기
API의 인증/인가 검증을 손댈 때. 상태 코드, 응답 바디, 인증 상태를 단계별로 확인해야 보안 구멍을 만들지 않는다.
계속 읽기 →웹 앱이 느려졌을 때 성능 디버깅하는 법
아이콘 로드, CSS, 스크립트 실행 등 어디가 느린지 찾아야 한다. 로컬과 운영의 차이를 기록하면서 단계적으로 확인해야 한다.
계속 읽기 →