turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
서버에서만 301 리다이렉트가 안 먹힐 때
Nginx나 도메인 설정에서 301 리다이렉트가 정상 작동하지 않을 때의 진단과 해결 방법.
robots.txt 설정 확인 순서
검색 엔진 크롤러 차단이나 콘텐츠 노출 문제를 해결하기 위한 robots.txt 설정 확인 방법.
계속 읽기 →로컬에선 작동하는데 서버에서만 터질 때
애플리케이션 버전 차이로 로컬과 운영 환경에서 다르게 작동할 때 확인하는 순서.
계속 읽기 →배포 후 검색 엔진 크롤러가 내용을 못 읽을 때
Next.js 배포 후 Google이나 다른 크롤러가 페이지 콘텐츠를 제대로 수집하지 못할 때의 해결 방법.
계속 읽기 →배포 전에 unique 제약 확인하기
데이터베이스의 unique 제약 위반으로 배포 후 오류가 생길 때 확인하는 방법.
계속 읽기 →권한 문제로 사용자 입력이 막힐 때
웹 애플리케이션에서 권한 관련 에러로 사용자 입력이 실패할 때 확인하는 방법을 정리했다.
계속 읽기 →캐시 배포 후 데이터가 사라졌을 때
Next.js 배포 후 페이지가 제대로 렌더링되지 않거나 데이터가 빠져 있을 때 확인하는 순서를 정리했다.
계속 읽기 →API 요청 로그로 운영 환경 문제를 빠르게 진단하기
API 서버의 문제를 파악하려면, 모든 파일을 의심하기보다 먼저 네트워크, 프로세스, 저장소 상태를 확인해야 한다. 서버 운영의 기본 진단 순서를 정리했다.
계속 읽기 →푸시 알림 기능을 배포 전에 검증하기
푸시 알림은 클라이언트와 서버가 함께 작동해야 하는 기능이다. 배포 전에 각 단계별로 확인해야 할 체크리스트를 정리했다.
계속 읽기 →Next.js 앱 배포 후 첫 번째로 볼 로그들
배포 직후 문제를 찾으려면, 빌드 로그와 런타임 로그를 순서대로 확인해야 한다. 초보자가 놓치기 쉬운 진단 포인트들을 정리했다.
계속 읽기 →페이지네이션 쿼리 성능을 배포 전에 확인하기
페이지네이션은 대량의 데이터를 다룰 때 필수 기능이다. 배포 전에 쿼리 성능과 UI 동작을 확인하는 체크리스트를 정리했다.
계속 읽기 →웹 페이지 정렬 기능 배포 전 확인 사항
정렬 기능은 단순해 보이지만, 운영 환경에서는 성능 저하나 UI 버그로 이어질 수 있다. 배포 전에 확인해야 할 체크리스트를 정리했다.
계속 읽기 →DB 마이그레이션 실행 전 확인해야 할 것들
운영 데이터베이스에 스키마 변경을 적용하기 전에, 마이그레이션 상태와 권한을 꼼꼼히 확인하는 과정이 필수다. 실수로 인한 데이터 손실을 막는 체크리스트를 정리했다.
계속 읽기 →Docker 컨테이너의 권한 문제를 진단하는 방법
Docker 컨테이너에서 권한 에러가 발생하면, 원본 이미지의 설정부터 실행 환경까지 여러 곳을 확인해야 한다. 체계적인 진단 순서를 정리했다.
계속 읽기 →Docker prune로 인한 예기치 않은 이슈 디버깅
docker prune 명령어로 사용하지 않는 이미지를 정리하다 보면, 때때로 필요한 리소스까지 삭제되는 경우가 있다. 이 문제를 체계적으로 진단하는 방법을 정리했다.
계속 읽기 →TypeScript 타입 에러를 빠르게 찾아내는 체크리스트
TypeScript 프로젝트가 커지면 타입 에러가 산발적으로 발생한다. 빌드 에러와 런타임 문제를 구분하고 체계적으로 해결하는 방법을 정리했다.
계속 읽기 →로딩 상태가 모바일에서만 이상할 때 확인하기
데스크톱에선 로딩이 자연스럽지만 모바일에서는 버벅거리거나 상태가 제대로 안 보이는 경험을 했다. 이런 환경별 차이를 빠르게 찾는 방법을 정리했다.
계속 읽기 →검색 노출이 안 될 때 Next.js 메타데이터 확인하기
sitemap.xml은 정상인데 검색 노출이 이상하면, canonical 태그와 OG 메타데이터를 다시 확인해야 한다. Next.js 프로젝트에서 간단한 디버깅 순서를 정리했다.
계속 읽기 →배포했는데 설정이 다르게 보일 때 원인 찾기
로컬 개발 환경에선 잘 작동하던 설정이 운영 환경에서 다르게 동작하는 일이 있다. 이럴 때 체계적으로 원인을 좁혀가는 방법을 정리했다.
계속 읽기 →앱 아이콘이나 UI가 사용자 입력으로 버그를 일으킬 때
특정 상황에서만 버그가 보이면, 재현 조건을 먼저 정리하고 스타일 설정부터 확인하는 방법을 정리했다.
계속 읽기 →API 연동이 릴리즈에서만 깨질 때
로컬에서는 되는데 배포된 앱에서만 API 호출이 실패하면, 먼저 확인할 것을 정리했다.
계속 읽기 →운영 데이터베이스 문제를 빠르게 진단하기
검색해서 바로 따라 하지 말고, 재현 조건을 먼저 잡는 방법을 정리했다.
계속 읽기 →로컬 데이터베이스 쿼리가 자꾸 느려질 때
목록 조회 속도가 갑자기 느려지면, 스키마와 데이터부터 확인하는 방법을 정리했다.
계속 읽기 →Flutter 앱이 실기기에서만 이상할 때
로컬 시뮬레이터에서는 잘 되는데 실제 폰에서 문제가 생기면, 어디부터 확인해야 하는지 정리했다.
계속 읽기 →