turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
웹 앱 배포 전 에뮬레이터에서 마지막 점검할 때
실제 배포하기 전에 에뮬레이터 환경에서 최종 점검을 해야 한다. 로컬과 에뮬레이터 환경의 차이를 파악하는 방법을 정리했다.
서버 운영 중 데이터 문제가 나타났을 때
프로덕션 서버에서 데이터 누락이나 손상이 발생하면 빠른 진단과 대응이 필수다. 운영 중 데이터 문제를 진단하는 방법을 정리했다.
계속 읽기 →TypeScript 제네릭 타입 체크 에러가 나올 때
TypeScript에서 제네릭을 사용할 때 복잡한 타입 에러가 발생할 수 있다. 이럴 때 어디서부터 확인해야 할지 정리했다.
계속 읽기 →파일 업로드 API가 생각하는 대로 작동하지 않을 때
사용자가 보는 화면과 백엔드가 실제로 처리하는 로직이 맞지 않으면 파일 업로드가 실패할 수 있다. 이럴 때 빠르게 진단하는 방법을 정리했다.
계속 읽기 →배포 전에 확인해야 할 관계형 데이터 설정
데이터베이스의 외래키나 제약 조건이 제대로 설정되지 않으면 배포 후 예상치 못한 에러가 발생할 수 있다. 배포 전 체크 방법을 정리했다.
계속 읽기 →Nginx 리버스 프록시가 요청을 제대로 전달하지 않을 때
Nginx 설정이 조금만 어긋나도 요청이 제대로 전달되지 않거나 응답 헤더가 손상될 수 있다. 이럴 때 체크할 순서를 정리했다.
계속 읽기 →웹 빌드 결과가 로컬과 배포 서버에서 다를 때
Next.js나 React로 빌드한 결과가 로컬 환경에서는 멀쩡한데 배포 서버에서는 이상하게 작동할 수 있다. 이런 환경 차이를 빠르게 파악하는 방법을 정리했다.
계속 읽기 →React에서 상태 이름을 잘못 지었을 때
리액트 컴포넌트의 상태 이름이 혼란스러우면 렌더링 로직도 헷갈리기 쉽다. 특히 boolean 상태의 이름을 명확히 하는 것이 중요하다.
계속 읽기 →API 응답이 예상과 다를 때 확인 순서
API를 호출할 때 상황에 따라 다른 응답이 나오는 경우가 있다. 이럴 때 체계적으로 원인을 찾는 방법을 정리했다.
계속 읽기 →Next.js 앱의 SEO가 이상할 때 먼저 볼 것
웹앱의 메타 태그나 ogTag가 제대로 나타나지 않으면 검색 엔진 최적화는 물론 소셜 미디어 공유도 제대로 되지 않는다. 이때 체크할 순서를 정리했다.
계속 읽기 →Prisma migration이 로컬에서는 되는데 서버에서 터질 때
Prisma를 쓰다 보면 로컬 개발 환경에서는 성공한 마이그레이션이 실제 서버에서만 실패하는 경우가 있다. 이때 빠르게 원인을 찾는 방법을 정리했다.
계속 읽기 →Android 에뮬레이터와 실기기에서 다르게 나타날 때
Flutter 앱을 개발할 때 에뮬레이터에서는 잘 작동하는데 실제 기기에서만 문제가 생기는 경우가 있다. 이때 빠르게 진단하는 방법을 정리했다.
계속 읽기 →React 컴포넌트를 분리할 때 렌더링 문제가 생기면
부모 컴포넌트에서 자식으로 props를 나눠 주면서 화면이 깜빡이거나 상태가 꼬인다면, 렌더링 조건과 이벤트 흐름을 점검해야 한다.
계속 읽기 →API에서 대량 파일 업로드를 처리할 때 배포 전 확인
파일 업로드 엔드포인트가 느려지거나 실패하면, 타임아웃, 파일 크기 제한, 디스크 공간을 순서대로 확인한다.
계속 읽기 →데이터베이스 unique 제약이 문제를 일으킬 때 배포 전 확인
배포 후 "duplicate key value" 에러가 나면, 데이터 마이그레이션, 제약 조건 순서, 기존 데이터를 점검해야 한다.
계속 읽기 →개인 프로젝트에서 DNS 레코드 설정을 할 때 필수 확인 사항
새 도메인을 연결하거나 DNS를 수정한 뒤 뭔가 안 보인다면, 메타데이터, canonical 태그, DNS 레코드 순서대로 확인한다.
계속 읽기 →Docker 이미지 생성 서비스가 느려질 때 원인 좁히기
OG 이미지나 썸네일 생성 서비스가 느려지면, 컨테이너 리소스, 이미지 캐시, 네트워크 요청을 확인해야 한다.
계속 읽기 →Next.js 폰트가 로컬에서는 되는데 배포 서버에서만 실패할 때
빌드는 로컬에서만 성공하는 경우, 폰트 파일 경로, 빌드 환경, 도메인 설정을 점검해야 한다.
계속 읽기 →VPS 재부팅 후 애플리케이션이 안 떠올 때 확인 순서
서버를 재부팅한 뒤 앱이 시작되지 않으면, 디스크, 프로세스, 포트 바인딩을 순서대로 확인하면 대부분 해결된다.
계속 읽기 →React 낙관적 업데이트가 깜빡일 때 원인 찾는 방법
UI는 즉시 반응하는데 서버 응답 후 다시 바뀐다면, 이벤트 흐름과 상태 동기화를 점검해야 한다.
계속 읽기 →Google Play 배포 후 앱이 이상할 때 먼저 볼 것
Play Console에 업로드하면 뭔가 달라 보인다면, 버전 코드, 타겟 API, 서명 설정을 순서대로 확인하면 된다.
계속 읽기 →Flutter 실기기에서 앱이 느려졌을 때 배포 전 확인할 것
실기기 테스트에서 앱 성능이 떨어진 것 같으면 빌드 모드, 의존성, API 응답 속도를 순서대로 확인해야 한다.
계속 읽기 →Docker 컨테이너의 이미지가 제대로 로드되지 않을 때
Docker 이미지 로딩 문제는 보통 마운트, 포트 매핑, 환경 변수 중 하나다. 확인 순서를 정해 두면 훨씬 빨리 원인을 찾을 수 있다.
계속 읽기 →Next.js 메타데이터가 배포 환경에서 안 보일 때
빌드는 성공하는데 배포된 페이지의 메타데이터가 이상할 때 확인할 순서를 정리했다.
계속 읽기 →