turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
React 버튼 상태를 안전하게 바꾸는 법
로컬에서 괜찮았던 설정도 배포 환경에서는 다르게 동작할 수 있다. 각 환경에서 실제로 테스트해 보자.
개인 프로젝트에서 로그 로테이션 설정하기
서버 로그가 계속 쌓이다 보면 디스크가 가득 찬다. 처음부터 로그 로테이션을 제대로 해 두면 나중에 신경 쓸 일이 줄어든다.
계속 읽기 →Next.js에서 서버 렌더링만 실패할 때 확인 순서
로컬에서는 잘 되지만 서버에서만 터지는 문제는 대부분 메타데이터나 canonical 설정이 원인이다.
계속 읽기 →TypeScript Record 타입 리팩터링할 때 실수 줄이기
TypeScript에서 타입을 수정할 때는 화면만 보고 판단하면 놓치는 게 많다. 빌드 에러와 타입 정의를 함께 확인해야 한다.
계속 읽기 →에러 페이지를 안전하게 수정하는 방법
한 번에 여러 파일을 고치면 뭐가 문제인지 알기 어렵다. 작은 부분씩 바꾸고 확인하면서 진행하자.
계속 읽기 →React 폼 타입 리팩터링할 때 실수하지 않으려면
타입 문제를 한 번에 고치려다 보면 모든 파일이 의심스러워진다. 작은 부분부터 차근차근 확인하면서 수정하자.
계속 읽기 →Dockerfile 빌드 실패할 때 로그 읽는 순서
컨테이너가 예상대로 동작하지 않을 때, 로컬과 운영 환경의 차이를 함께 비교하면서 단계적으로 원인을 좁혀야 한다.
계속 읽기 →배포 빌드 시간이 자꾸 길어진다면
npm run build가 예전보다 오래 걸리기 시작했을 때 원인을 찾고 최적화하는 방법.
계속 읽기 →TypeScript 타입이 맞지 않을 때
props나 API 응답의 타입이 변해서 빌드 에러가 날 때 안전하게 대응하는 방법.
계속 읽기 →React 폼 검증이 안 먹을 때
폼 검증 로직이 설정돼도 에러 메시지가 안 보이거나 제출이 안 될 때의 진단.
계속 읽기 →Flutter 테마 적용이 일부만 먹을 때
Flutter 앱에서 테마 설정이 모든 위젯에 일관되게 적용되지 않을 때의 체크리스트.
계속 읽기 →Docker 이미지 용량이 커지면 언제 롤백할까
배포 후 이미지 용량 증가를 발견했을 때 원인을 파악하고 조치하는 방법.
계속 읽기 →모바일에서 폼 입력이 불편할 때
모바일 기기에서 폼 입력이 답답하거나 레이아웃이 깨질 때의 원인 찾기.
계속 읽기 →Next.js 캐시가 먹지 않을 때
환경변수가 설정돼도 메타 태그가 갱신 안 될 때 확인할 점들.
계속 읽기 →Docker 컨테이너 로그로 시작하기
컨테이너에서 문제가 나면 로그를 체계적으로 확인하는 방법.
계속 읽기 →로컬에서 안 나는 버그가 서버에서만 터질 때
개발 환경에서는 정상인데 배포 서버에서만 문제가 발생할 때 확인할 점들.
계속 읽기 →React 로딩 상태가 꼬일 때
컴포넌트의 로딩 상태가 제대로 업데이트되지 않거나 UI가 튈 때 원인 찾기.
계속 읽기 →서버의 권한 팝업 문제 진단하기
운영 중 권한 관련 팝업이나 로그 에러가 나면 서버의 실제 상태를 확인하는 순서.
계속 읽기 →웹폰트 로딩이 튀면 확인 순서
웹폰트가 늦게 로드되거나 폰트 렌더링이 꼬일 때 체계적으로 디버깅하는 방법.
계속 읽기 →개인 프로젝트의 검색 기능을 빠르게 확인하는 방법
검색해서 들어온 상황이라면 재현 조건부터 정확히 파악하자. 문제 해결 전체 흐름에서 원인을 좁혀가는 체계적 접근.
계속 읽기 →React에서 실제 서비스 기준 모달을 안전하게 수정하기
혼자 개발할수록 확인한 값과 바꾼 값을 따로 남기는 습관이 중요하다. 모달 문제를 체계적으로 진단하는 방법.
계속 읽기 →데이터베이스 트랜잭션 잠금으로 막힐 때 확인 순서
문제를 크게 잡으면 모든 파일이 의심스러워진다. 트랜잭션 문제는 설정과 로그부터 단계적으로 좁혀가면 빠르게 해결된다.
계속 읽기 →Next.js에서 sitemap.xml과 RSS 피드를 관리하는 방법
운영 중에는 작은 이상 신호도 빨리 분리해서 봐야 한다. sitemap과 RSS의 상태를 정기적으로 확인하는 습관.
계속 읽기 →Next.js Route Handler에서 메타데이터를 다루는 디버깅 흐름
화면 하나만 보고 판단하면 놓치는 게 많다. 로그와 응답을 함께 보면서 메타데이터 문제를 체계적으로 진단하자.
계속 읽기 →