turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
API 응답 형식이 바뀔 때 안전하게 대응하기
API 응답 DTO를 변경할 때는 기존 클라이언트와의 호환성을 먼저 확인하고, 필드를 점진적으로 추가하거나 제거해야 한다.
Play Console에 배포하기 전에 확인할 것
앱을 스토어에 출시하기 전에는 빌드 결과, 설정, 실제 동작을 모두 검증해야 나중에 리젝이나 버그 리포트를 줄일 수 있다.
계속 읽기 →Next.js에서 메타데이터가 제대로 나오지 않을 때
HTML head 태그의 메타데이터, canonical, OG 태그가 빌드 후 실제 페이지에 반영되는지 먼저 확인하자.
계속 읽기 →서버 디스크 용량이 부족할 때 확인할 것
배포 직후 갑자기 디스크 용량이 줄어들었다면, 로그, 캐시, 임시 파일을 먼저 확인하자.
계속 읽기 →React 낙관적 업데이트가 어긋날 때 확인 순서
로컬에서 완벽했던 낙관적 업데이트도 배포 환경에서는 타이밍, 네트워크 지연, 캐시 상태에 따라 상태가 꼬일 수 있다.
계속 읽기 →TypeScript 타입 가드에서 놓치기 쉬운 부분
타입 가드는 null 체크와 제대로 구분해야 하고, 빌드 타임에 오류를 모두 잡아낼 수는 없으므로 런타임 검증이 필요하다.
계속 읽기 →방화벽 규칙 변경할 때 서버 잠금 피하기
방화벽 설정을 바꿀 때는 먼저 현재 상태를 정확히 파악하고 작은 단위로 검증해야 다음 문제를 빠르게 처리할 수 있다.
계속 읽기 →빌드 에러로 인한 배포 실패 예방하기
운영 환경에서 발생하는 빌드 에러를 배포 전에 미리 발견하고 해결하는 체크리스트입니다.
계속 읽기 →실전 서비스에서 레이트 제한 운영하기
실제 사용자를 처리하는 서비스에서 API 레이트 제한을 안정적으로 유지하는 방법입니다.
계속 읽기 →시드 데이터 중복 제거 및 관리 방법
개발/테스트 환경에서 시드 데이터가 중복되는 문제를 해결하는 체계적인 접근법입니다.
계속 읽기 →웹 라우팅 문제 빠르게 해결하기
초보자가 쉽게 놓치는 라우팅 설정 오류와 그 해결 방법을 정리했습니다.
계속 읽기 →Docker 컨테이너 이미지 문제 디버깅
Docker 환경에서 이미지 로딩 실패나 컨테이너 구동 문제를 원인별로 체계적으로 확인하는 방법입니다.
계속 읽기 →운영 중 발견되는 성능 문제 원인 추적하기
배포 후 운영 중에 발견되는 성능 저하나 볼륨 문제를 체계적으로 진단하는 방법입니다.
계속 읽기 →파일 권한으로 인한 배포 문제 사전 차단
배포 후에 권한 문제로 서비스가 실패하는 상황을 미리 예방하는 체크리스트입니다.
계속 읽기 →데이터베이스 쿼리 성능 문제 진단하기
특정 정렬 조건에서 데이터베이스 쿼리가 느려질 때 원인을 체계적으로 찾는 방법입니다.
계속 읽기 →서버 시간대 안전하게 변경하는 방법
운영 중인 서버의 시간대를 변경할 때 발생할 수 있는 문제와 안전한 변경 절차를 정리했습니다.
계속 읽기 →서버 상태 확인과 백업 전략
서버 운영 중 발생할 수 있는 관계형 데이터와 백업 문제를 체계적으로 확인하는 순서를 정리했습니다.
계속 읽기 →레이트 제한을 고려한 대량 데이터 처리 계획
대량의 데이터를 처리할 때 API 레이트 제한으로 인한 문제를 미리 예방하는 체크리스트를 정리했습니다.
계속 읽기 →빌드할 때만 나는 타입 에러 디버깅하기
로컬에서는 돌아가는데 빌드 시점에만 타입 에러가 나왔던 경험을 정리했습니다.
계속 읽기 →로그인 상태가 자꾸 풀릴 때
React 앱에서 세션이나 토큰이 유실되는 문제를 진단하는 순서입니다.
계속 읽기 →운영 DB에서 파일을 못 열 때
데이터베이스 파일 권한, 마운트 포인트, 디스크 할당량을 확인하는 방법입니다.
계속 읽기 →배포 전 멱등성 확인하기
같은 요청을 여러 번 실행해도 안전한지 배포 전에 확인해야 할 체크리스트입니다.
계속 읽기 →Next.js Server Component가 예상과 다르게 동작할 때
Server Component에서 발생하는 데이터 페칭, 캐싱, 렌더링 문제를 찾는 방법입니다.
계속 읽기 →서버에서만 로그 로테이션이 실패할 때
디스크 용량과 권한 문제로 인한 로그 로테이션 실패를 디버깅하는 방법입니다.
계속 읽기 →