turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
Prisma 마이그레이션이 실패했을 때 대응
Prisma migration이 실패했을 때 상태를 확인하고 단계적으로 복구하는 절차.
배포 전 Server Component 동작 검증
Next.js App Router에서 Server Component가 실제로 올바르게 동작하는지 배포 전에 확인하는 방법.
계속 읽기 →SNS 공유 미리보기가 깨질 때
웹 페이지를 SNS에 공유할 때 제목, 설명, 이미지가 제대로 표시되지 않을 때 수정하는 방법.
계속 읽기 →TypeScript null 처리: 런타임 데이터가 타입과 다를 때
타입 정의는 맞는데 런타임에서 null이 튀어나오는 문제를 빠르게 해결하는 방법.
계속 읽기 →SQLite 볼륨 배포 후 데이터가 갑자기 사라졌을 때
SQLite 데이터가 배포 후 초기화되는 문제를 빠르게 진단하는 방법.
계속 읽기 →Flutter 앱 검색 UI 모바일에서 깨질 때 확인할 것
모바일 검색 UI가 제대로 렌더링되지 않을 때 실제로 도움이 되는 확인 순서.
계속 읽기 →Next.js 페이지 속도가 갑자기 느려졌을 때
Next.js 프로젝트에서 페이지 로딩 속도가 저하되었을 때 원인을 빠르게 찾는 체크리스트.
계속 읽기 →Docker 컨테이너가 서버에서만 실패할 때
로컬에서는 정상 작동하는 Docker 컨테이너가 서버 배포 후 에러를 일으킬 때 로그를 읽고 원인을 찾는 방법.
계속 읽기 →TypeScript optional 타입 에러 원인 찾기
optional 값 처리에서 타입 에러가 발생할 때 빌드를 실패시키지 않고 체계적으로 원인을 좁혀가는 방법.
계속 읽기 →빌드가 로컬에서는 되는데 서버에서만 실패할 때
로컬 개발 환경과 배포 환경의 차이로 인한 빌드 실패를 진단하고 해결하는 방법.
계속 읽기 →빌드 후 검색 노출이 어색할 때
Next.js나 정적 생성 프로젝트에서 빌드 후 SEO 메타데이터가 제대로 반영되지 않을 때 확인할 항목.
계속 읽기 →개발할 때 충분한 디스크 공간 확보하기
로컬 개발 환경에서 디스크 부족 문제로 시간을 낭비하지 않도록 미리 체크하는 방법.
계속 읽기 →낙관적 업데이트가 막힐 때 배포 전 체크
UI에서 낙관적 업데이트를 구현했을 때 서버와 상태가 불일치하는 문제를 배포 전에 검증하는 방법.
계속 읽기 →배포 후 데이터가 안 보일 때 확인 순서
배포한 후 데이터베이스 관계가 제대로 표시되지 않을 때 체계적으로 문제를 좁혀가는 방법.
계속 읽기 →검색 UI 응답이 늦을 때 원인 찾기
검색 기능이 응답을 지연시킬 때 원인을 빠르게 찾는 체크리스트와 실제 확인 순서를 정리했다.
계속 읽기 →React 컴포넌트 props가 운영에서 다르게 동작할 때
개발 환경과 프로덕션 환경에서 컴포넌트가 다르게 보이거나 동작하는 경우와 디버깅 방법.
계속 읽기 →개발 초보가 프론트엔드 버그를 찾을 때 빠지기 쉬운 함정
복잡한 문제로 보이지만 실제로는 간단한 원인인 경우가 많다. 먼저 확인해야 할 것들.
계속 읽기 →서버에서 데이터베이스 파일을 열지 못할 때
프로덕션 서버에서 "Permission denied" 같은 DB 파일 접근 에러가 나는 경우와 해결법.
계속 읽기 →배포 직전에 앱 성능을 빠르게 점검하는 법
프로덕션 배포 전에 로컬에서 할 수 있는 성능 체크리스트와 일반적인 함정들.
계속 읽기 →Dockerfile을 배포 전에 점검하는 방법
Docker 이미지 빌드가 실패하거나 실행 중에 문제가 생기는 것을 미리 방지하는 체크리스트.
계속 읽기 →도메인 로그가 갑자기 많아졌을 때 원인 찾기
운영 중에 액세스 로그가 갑자기 급증하면 먼저 정상인지 이상인지 판단하는 방법.
계속 읽기 →개인 프로젝트의 slug 버그를 빠르게 찾는 법
Next.js에서 slug 기반 라우팅이 제대로 동작하지 않을 때 원인을 찾는 체계적인 접근법.
계속 읽기 →운영 서버에서 디스크 용량으로 배포가 실패할 때
로컬에서는 괜찮다가 운영 서버에서만 디스크 부족으로 실패하는 상황을 빠르게 진단하는 방법.
계속 읽기 →Next.js 서버 액션을 안전하게 수정하는 법
서버 액션은 클라이언트와 서버 사이의 경계이기 때문에, 수정할 때 조심해야 할 부분들이 있다.
계속 읽기 →