turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
연결 문자열이 실제로 반영됐는지 서버에서 확인하기
DATABASE_URL 같은 환경 변수가 정말 적용됐는지, 운영 환경에서 확인하고 문제를 재현하는 방법.
TypeScript 타입 가드가 제대로 작동하지 않을 때
컴파일은 되는데 런타임에 타입 에러가 나거나, 타입 가드 로직이 누락될 때의 진단법.
계속 읽기 →React 폼이 서버에서만 제출 안 될 때 디버깅
로컬에선 멀쩡한데 운영 서버에서만 폼 제출이 안 될 때의 체크리스트.
계속 읽기 →Next.js에서 sitemap.xml이 제대로 생성 안 될 때
sitemap이 비어있거나 URL이 누락됐을 때 어디서부터 확인할지 정한 흐름.
계속 읽기 →DB 스키마 변경이 안 먹혔을 때 확인하는 순서
스키마 마이그레이션이 적용 안 된 것처럼 보일 때, 실제 원인을 빠르게 찾는 체크리스트.
계속 읽기 →릴리즈 배포 전에 확인할 최종 체크리스트
배포 직전의 30분이 가장 중요하다. 빌드 로그를 읽고 실제 배포될 파일들을 확인하는 것으로 80%의 문제를 예방할 수 있다.
계속 읽기 →로딩 상태에서 폼 입력이 막혀 있을 때 디버깅하기
사용자가 폼을 입력하는 중에 로딩이 시작되면 입력이 먹통이 되는 경우가 자주 생긴다. 상태와 렌더링 순서를 확인해야 한다.
계속 읽기 →운영 환경 Postgres 점검 체크리스트
Postgres 문제는 로컬에서 예상하지 못한 경우가 많다. 배포 전에 반드시 확인할 항목들을 정리했다.
계속 읽기 →검색 기능이 원하는 결과를 못 찾을 때 디버깅하기
사용자가 검색어를 입력했는데 결과가 없다고 보고한다. 보통 쿼리 로직, 인코딩, 또는 환경 차이에서 문제가 비롯된다.
계속 읽기 →React 상태 관리가 꼬였을 때 따라갈 흐름
화면이 예상과 다르게 렌더링되면 상태 변화를 시간 순서대로 추적하는 게 가장 빠르다.
계속 읽기 →배포 후 모달 UI가 깨져 보일 때 디버깅하기
React 컴포넌트는 로컬에서 완벽해도 배포 후 모달이 닫혀 있거나 오버레이가 안 나타날 수 있다. 상태 관리와 CSS를 함께 확인해야 한다.
계속 읽기 →배포 전에 로컬 DB 상태를 점검하는 체크리스트
데이터베이스 마이그레이션 누락이나 스키마 불일치는 배포 후 치명적 문제가 된다. 배포 전에 반드시 확인할 항목들을 정리했다.
계속 읽기 →sitemap.xml이 크롤러에게 제대로 읽히는지 확인하기
sitemap.xml 문제는 대부분 URL 구조 오류나 메타데이터 누락에서 비롯된다. 빌드 후 직접 내용을 확인해야 한다.
계속 읽기 →배포 후 데이터가 보이지 않을 때 페이지네이션 체크하기
페이지네이션 버그는 보통 쿼리 로직이 아니라 파라미터 전달이나 환경 설정에서 비롯된다.
계속 읽기 →robots.txt 문제를 체계적으로 디버깅하기
robots.txt가 제대로 작동하는지 확인하려면 실제 크롤러 관점에서 파일 내용과 서버 응답을 함께 봐야 한다.
계속 읽기 →개인 프로젝트에서 에러를 빨리 잡는 체크리스트
웹 프로젝트가 빌드 실패할 때 막 수정하지 말고 문제를 정확히 정의한 뒤 단계적으로 접근하면 훨씬 빠르다.
계속 읽기 →혼자 API 개발할 때 원인을 좁히는 법
API 응답이 이상할 때 화면만 보면 놓치는 값이 많다. 요청과 응답 전체를 체계적으로 확인하는 순서를 정리했다.
계속 읽기 →파일 업로드 후 로그인이 자꾸 풀리는 문제
같은 기능도 로컬과 배포 환경에서 다르게 작동한다. 특히 파일 업로드와 인증 관련 요청이 그렇다.
계속 읽기 →Android 빌드가 실패할 때 확인하는 순서
Flutter로 Android 빌드하다가 자꾸 실패하는 경험. 검색해서 바로 따라 하면 안 되는 이유.
계속 읽기 →DNS 레코드 로그가 너무 많을 때 무엇부터 볼까
운영 중 로그가 폭주하면서 실제 에러를 놓치기 쉽다. DNS와 도메인 관련 로그를 필터링하는 방법.
계속 읽기 →빌드는 로컬에서 성공하는데 서버에서만 실패한다
환경변수 설정 문제로 보이지만, 실제는 빌드 타임과 런타임의 구분이 필요한 경우들.
계속 읽기 →Docker 이미지 크기가 커지는 이유
같은 Dockerfile로 빌드해도 어느날부턴 용량이 확 늘어나는 경험. 그 원인을 파악하는 방법.
계속 읽기 →Next.js에서 canonical URL 제대로 쓰기
SEO를 위해 canonical을 설정했는데 검색 엔진이 인식하지 못하는 문제. 빌드와 런타임에서 확인할 점들.
계속 읽기 →도메인 연결 서비스가 간헐적으로 느린 이유
같은 요청인데 어떨 땐 빠르고 어떨 땐 느린 도메인 문제. DNS부터 캐시까지 확인해야 할 것들.
계속 읽기 →