turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
DB unique 제약이 걸릴 때 확인 순서
프로젝트에서 데이터베이스 unique 제약 오류가 날 때 먼저 확인해야 할 것들입니다.
VPS 처음 세팅할 때 systemd 설정 실수
새 서버에서 서비스를 systemd로 관리할 때 자주 하는 실수들입니다.
계속 읽기 →prune 후에도 로컬과 서버 상태가 다를 때
Docker prune을 실행한 후에도 문제가 지속될 때 확인해야 할 것들입니다.
계속 읽기 →Dockerfile 이미지가 갑자기 커졌을 때
빌드 이미지 크기가 증가했을 때 어디서 용량이 커졌는지 찾는 방법입니다.
계속 읽기 →Docker 이미지가 로컬에서는 잘되는데 서버에서 안 될 때
컨테이너가 환경에 따라 다르게 동작할 때 확인해야 할 로그와 설정들입니다.
계속 읽기 →서버 재부팅 전에 확인하는 것들
배포나 서버 점검 전에 미리 확인해야 할 디스크, 로그, 프로세스를 정리했습니다.
계속 읽기 →TypeScript optional 값이 null일 때 디버깅하기
optional 체이닝이 예상과 다르게 동작할 때 확인해야 할 것들을 정리했습니다.
계속 읽기 →SQLite 데이터베이스를 안전하게 배포하고 롤백하기
SQLite 데이터베이스를 볼륨에 저장하는 프로젝트는 배포 전에 백업과 마이그레이션을 미리 확인해야 한다.
계속 읽기 →Docker 컨테이너의 크롤러가 콘텐츠를 읽지 못할 때
Docker로 배포한 앱이 검색 엔진 크롤러에게 읽히지 않는다면, 컨테이너 상태와 로그를 확인해야 한다.
계속 읽기 →React에서 낙관적 업데이트가 제대로 안 될 때
폼 입력이 불편하고 낙관적 업데이트가 제대로 작동하지 않는다면, 이벤트 흐름과 렌더링 조건을 확인해야 한다.
계속 읽기 →API 응답이 예상과 다를 때 확인하는 방법
같은 요청을 했는데 응답이 달라진다면, 요청 파라미터부터 확인해야 한다. API 디버깅의 기본 순서를 정리했다.
계속 읽기 →API 에러 응답의 형식이 일정하지 않을 때 고치는 방법
에러가 발생했을 때 API 응답 형식이 달라진다면, 클라이언트는 에러를 제대로 처리할 수 없다. 응답 형식을 통일하는 순서를 정리했다.
계속 읽기 →모바일에서만 레이아웃이 깨질 때 확인 순서
운영 서버에서만 모바일 레이아웃이 깨진다면, 화면 크기뿐 아니라 로그와 응답도 함께 확인해야 한다.
계속 읽기 →Next.js 서버 액션을 사용한 글 상세 페이지에서 메타데이터가 안 먹힐 때
로컬에서는 정상이던 메타데이터가 배포 환경에서 제대로 생성되지 않는다면, 서버 액션과 메타데이터 생성 시점을 확인해야 한다.
계속 읽기 →Flutter 프로젝트에서 Gradle 빌드가 실패할 때
모바일 앱을 빌드할 때 Gradle 에러가 나면 처음부터 정답을 찾으려고 하지 말고, 먼저 현재 상태부터 파악해야 한다.
계속 읽기 →브라우저에서 CORS 에러가 나면 확인할 것
프론트엔드와 API 서버가 다른 도메인에 있으면 CORS 에러가 난다. 어디서 뭘 잘못 설정했는지 찾는 순서를 정리했다.
계속 읽기 →Next.js에서 SEO 메타데이터가 제대로 반영되지 않을 때
검색 엔진 크롤러가 페이지의 제목, 설명, 이미지를 읽지 못한다면 SEO 메타데이터를 확인해야 한다. Next.js 프로젝트에서 확인할 순서를 정리했다.
계속 읽기 →개발할 때 빌드 실수를 줄이는 방법
혼자 개발할 때는 확인한 값과 바꾼 값을 따로 남기는 습관이 필요하다. 빌드가 실패했을 때 뭐가 잘못됐는지 추적하는 순서를 정리했다.
계속 읽기 →배치 작업이 운영 서버에서만 실패할 때 확인 순서
로컬에서는 정상이던 배치 작업이 운영 서버에서 터진다면, 환경 차이를 체계적으로 확인해야 한다. 순서대로 확인할 사항들을 정리했다.
계속 읽기 →Flutter 라우팅이 에뮬레이터와 실기기에서 다를 때
모바일 앱의 라우팅 문제는 개발 환경에서는 안 나타나다가 실기기에서 터진다. 문제를 체계적으로 좁혀나가는 절차를 익혀두자.
계속 읽기 →혼자 개발할 때 서버 문제를 진단하는 표준 절차
서버 운영 문제는 로컬과 달라서 까다롭다. 혼자 다루려면 매번 같은 순서로 확인하는 습관이 필요하다.
계속 읽기 →Next.js 폼 입력이 느려졌을 때
폼 빌드 시간이 늘어나거나 입력 반응이 느려지는 건 여러 곳에서 비롯될 수 있다. 검색해서 온 상황이라면 현재 상태부터 명확히 파악하자.
계속 읽기 →React 상태 관리가 꼬였을 때 풀기
상태 이름이나 업데이트 로직이 복잡해지면 버그가 난다. 처음부터 정답을 찾으려 하지 말고, 체계적으로 원인을 좁혀나가자.
계속 읽기 →데이터베이스 스키마를 안전하게 수정하는 방법
운영 중 스키마 변경은 신중함이 필수다. 작은 이상 신호도 빨리 포착하고, 각 단계마다 정상 상태를 확인하면서 진행한다.
계속 읽기 →