turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
React에서 useEffect 배포 문제를 디버깅하기
useEffect는 로컬에서 완벽해도 배포 환경에서 다르게 작동할 수 있다. 환경 차이를 먼저 확인해야 한다.
Flutter 실기기에서 디버깅할 때 확인해야 할 것들
Flutter 앱이 시뮬레이터에서는 잘 작동하지만 실기기에서 에러가 나면, 환경과 빌드 모드부터 확인한다.
계속 읽기 →Docker 로그를 읽고 컨테이너 문제를 진단하는 방법
Docker 서비스가 실패하면, 로그, 포트, 환경변수를 순서대로 확인해야 문제를 빠르게 찾을 수 있다.
계속 읽기 →배포 전에 정렬 로직이 제대로 작동하는지 확인하기
정렬 함수의 버그는 작은 데이터셋에서는 눈에 띄지 않지만, 배포 후 실제 데이터로 테스트하면 드러난다.
계속 읽기 →웹 배포 전 배열 필터링 로직 검증하기
배포 전에는 로컬 환경에서 제대로 동작하던 배열 필터가 운영 환경에서 다르게 작동할 수 있다.
계속 읽기 →Flutter 테마 문제를 빠르게 디버깅하는 순서
Flutter에서 테마가 제대로 반영되지 않을 때는 환경과 빌드 상태를 먼저 확인해야 한다.
계속 읽기 →서버에서 DB 파일을 못 열 때 디버깅 흐름
DB 파일 접근 에러가 나면 환경 상태와 권한을 동시에 봐야 원인을 빠르게 찾을 수 있다.
계속 읽기 →React useEffect로 모바일 레이아웃이 깨질 때
로컬에서 괜찮았던 코드도 모바일 환경에서는 다르게 동작할 수 있다.
계속 읽기 →포트 충돌로 서비스가 느릴 때 원인 좁히기
정답을 먼저 찾으려 하면 오히려 확인 시간이 길어진다. 단계별로 좁혀나가야 한다.
계속 읽기 →TypeScript와 Prisma 타입 안정성 확인하기
운영 중에는 작은 이상 신호도 빨리 분리해서 봐야 타입 불안정성을 막을 수 있다.
계속 읽기 →Docker 컨테이너 로그 다루기
Docker 작업에서 로그를 어떻게 확인하고 해석하는지가 문제 해결 속도를 좌우한다.
계속 읽기 →OG 이미지가 제대로 미리보기되지 않을 때
소셜 미디어에 공유한 링크의 이미지가 깨져 보인다면, 확인할 순서가 있다.
계속 읽기 →페이지네이션 관리자 기능 만들 때 실수 줄이기
페이지네이션은 작은 기능처럼 보이지만 로컬과 운영 환경에서 다르게 동작하기 쉽다. 기본을 먼저 확인하자.
계속 읽기 →Docker 이미지가 너무 클 때 줄이는 기준
빌드 후 이미지 크기가 예상과 다르면 불필요한 레이어를 찾아야 한다. 로그와 inspect로 한 층씩 확인한다.
계속 읽기 →TypeScript 배열 필터링 타입 에러 체크리스트
배열을 필터링할 때 타입이 틀리면 런타임에는 괜찮아도 빌드가 실패한다. 빌드 에러를 먼저 읽으면 된다.
계속 읽기 →SSH 외부 접속 문제를 안전하게 해결하는 법
서버에 SSH로 못 들어가면 포트부터 권한까지 단계적으로 확인하되, 실수로 자신도 못 들어가는 상황을 피해야 한다.
계속 읽기 →React 목록 렌더링이 이상할 때 확인 순서
맵 함수로 목록을 그릴 때 key가 없거나 이벤트가 안 먹으면 사용자가 보는 게 전부가 아니다.
계속 읽기 →리버스 프록시 설정 확인하는 순서
VPS를 처음 세팅할 때 도메인이 제대로 연결되지 않으면 DNS부터 인증서까지 단계적으로 확인해야 한다.
계속 읽기 →Next.js 빌드가 실패할 때 처음 확인할 로그
API 타입 에러나 메타데이터 문제는 빌드 로그를 먼저 읽으면 90%는 바로 보인다.
계속 읽기 →Docker 헬스 체크가 실패할 때 확인하는 것
컨테이너 이미지가 너무 커지거나 헬스 체크가 자꾸 실패하면 환경변수와 로그를 함께 봐야 한다.
계속 읽기 →React 컴포넌트 상태가 꼬였을 때 먼저 할 일
컴포넌트를 분리했는데 상태가 이상하면 props 전달과 이벤트 버블링부터 확인하자.
계속 읽기 →React 폼 에러 메시지를 디버깅하는 흐름
폼이 제대로 안 보이거나 에러 문구가 사라지면 상태와 렌더링 흐름을 동시에 봐야 한다.
계속 읽기 →API 인증 쿠키 문제를 빨리 좁히는 법
인증 쿠키는 로컬에서 괜찮아도 서버 환경에서 달라진다. 요청과 응답을 함께 확인해야 한다.
계속 읽기 →React 상태 버그 확인하는 순서
상태 문제는 로컬에서 재현 조건을 정확히 잡아야 빨리 풀린다. 렌더링 조건부터 차근차근 확인해보자.
계속 읽기 →