turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
배포 후 검색 데이터가 안 보일 때
검색 기능 배포 후 데이터가 안 보이면 바로 재현 조건부터 정확히 파악해야 한다.
개인 프로젝트에서 Docker 볼륨 관리하기
운영 중에는 작은 이상 신호도 빨리 분리해서 봐야 한다. Docker 볼륨 설정이 잘못되면 데이터 손실로 이어질 수 있다.
계속 읽기 →빌드 시간이 길어질 때 확인해야 할 로그
Next.js로 구축한 프로젝트의 빌드 시간이 길어졌다면, 먼저 SEO 메타데이터와 sitemap을 확인해야 한다.
계속 읽기 →페이지네이션 쿼리를 바꾸기 전 확인할 것
데이터 계층 문제를 풀 때 문제를 크게 잡으면 모든 파일이 의심스러워져서 손대기 어려워진다.
계속 읽기 →페이지네이션으로 대량 데이터를 다룰 때
웹 개발에서 페이지네이션을 구현하다 보면 화면만으로는 파악하기 어려운 로그 문제가 숨어 있다.
계속 읽기 →운영 DB에서 데이터가 중복될 때
로컬에서 괜찮던 설정도 배포 환경에서는 다르게 보일 수 있다. 특히 데이터 중복은 마이그레이션 상태를 먼저 확인해야 한다.
계속 읽기 →배포 전에 확인해야 할 스키마 변경사항
데이터베이스 스키마를 변경하기 전에 처음부터 정답을 맞히려고 하면 오히려 시간이 더 걸린다.
계속 읽기 →로컬 DB 백업이 필요한 상황
운영 중에는 작은 이상 신호도 빨리 분리해서 봐야 한다. 특히 DB 관련 문제는 백업부터 확보하는 게 안전하다.
계속 읽기 →서버 재부팅 로그가 많을 때 디버깅하기
서버 운영 중 로그가 많으면 정상 상태를 먼저 정의하고 체계적으로 접근해야 한다.
계속 읽기 →리버스 프록시 설정을 안전하게 바꾸는 방법
Nginx 리버스 프록시를 운영할 때는 작은 확인이 큰 차이를 만든다.
계속 읽기 →포트 매핑 문제 디버깅 체크리스트
포트 매핑 설정 문제를 만났을 때, 작은 확인이 쌓이면 원인 후보가 자연스럽게 줄어든다.
계속 읽기 →트랜잭션 디버깅할 때 확인하는 순서
웹 개발에서 트랜잭션 문제를 만날 때, 로그와 응답을 함께 봐야 원인을 빨리 찾을 수 있다.
계속 읽기 →Next.js 메타데이터와 로딩 상태 체크하기
로컬에서 괜찮았던 설정도 배포 환경에서는 다르게 보일 수 있다는 점을 항상 기억해야 한다.
계속 읽기 →API 응답이 이상할 때 확인하는 순서
API 캐싱이나 응답 문제는 처음부터 정답을 찾으려 하면 시간이 오래 걸린다.
계속 읽기 →운영 중 에러 메시지 빠르게 진단하기
운영 중에는 작은 이상 신호도 빨리 분리해서 봐야 에러 확산을 막을 수 있다.
계속 읽기 →배포 후 네트워크 오류 빠르게 진단하기
배포 후 네트워크 문제를 진단하려면 재현 조건부터 먼저 잡아야 한다.
계속 읽기 →목록 정렬이 느려질 때 원인 찾기
정렬이나 조회가 느려질 때 확인한 값과 바꾼 값을 따로 남기는 습관이 중요하다.
계속 읽기 →React 상태 관리 문제 빠르게 찾기
React에서 상태가 꼬일 때 정답부터 찾으려 하면 오래 걸린다. 단계별로 확인해야 한다.
계속 읽기 →Flutter 라우팅 문제 빠르게 진단하는 법
Flutter 앱의 라우팅 문제를 진단할 때 문제를 크게 보고 단계별로 좁혀나가야 한다.
계속 읽기 →배포 전에 확인해야 할 웹 개발 체크리스트
배포 전 문제를 발견하려면 화면만 봐서는 부족하다. 로그와 응답을 함께 확인해야 한다.
계속 읽기 →API 인증 상태를 응답 코드와 본문으로 빠르게 진단하기
API 인증 에러를 debugging할 때, 상태 코드와 응답 본문의 에러 메시지만으로 원인의 대부분을 찾을 수 있습니다. 확인 순서를 정리했습니다.
계속 읽기 →Next.js에서 메타데이터와 canonical이 제대로 렌더링되는지 확인하기
Next.js 블로그나 웹사이트를 배포한 후, OG 태그와 canonical URL이 실제로 HTML에 포함되어 있는지 확인하는 방법을 정리했습니다.
계속 읽기 →API 인증 쿠키가 제대로 전달되는지 배포 전에 확인하기
API 인증 쿠키 문제는 로컬과 배포 환경이 다를 수 있습니다. curl로 간단하게 상태 코드와 응답을 확인해서 배포 전에 문제를 찾는 방법을 기록했습니다.
계속 읽기 →TypeScript 환경변수에서 null이 나올 때 타입 검증하기
환경변수 타입이 null이 되는 문제를 TypeScript 관점에서 정리했습니다. 타입 가드 확인과 빌드 검증 순서를 기록해두면 같은 실수를 줄일 수 있습니다.
계속 읽기 →