turin's blog
만들고, 터지고,
기록합니다
풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.
자주 다루는 주제
주제별로 빠르게 훑어보기
전체 글
운영 중 부딪힌 문제를 검색 의도에 맞춰 정리
배포 빌드가 오래 걸릴 때 첫 확인
빌드 시간이 길어지면 캐시 전략과 환경 차이부터 확인해야 한다. 로컬과 CI 환경이 다르다는 걸 간과하기 쉽다.
TypeScript 날짜 타입 props 문제 진단 순서
TypeScript에서 날짜 관련 props 정의가 복잡할 때 빌드 에러를 체계적으로 해결하는 방법입니다.
계속 읽기 →리버스 프록시(Nginx) 운영 중 확인 순서
운영 중 Nginx나 도메인 설정 문제가 생겼을 때 체계적으로 확인하는 방법입니다.
계속 읽기 →Next.js 정적 생성 운영 환경 점검 순서
정적 생성 방식으로 배포한 후 운영 중 발생할 수 있는 문제를 체계적으로 확인하는 방법입니다.
계속 읽기 →Next.js 배포 전 URL 슬러그 설정이 맞는지 확인하기
배포 전에 URL 구조와 슬러그 생성 방식을 점검하는 순서를 정리했습니다.
계속 읽기 →React 로딩 상태 표시가 꼬일 때 확인 순서
로딩 상태 관리가 잘못되어 표시가 뒤죽박죽일 때 원인을 찾는 방법입니다.
계속 읽기 →React 모달이 예상과 다르게 작동할 때 체크리스트
React 모달의 이벤트, 렌더링, 모바일 반응성을 체계적으로 확인하는 방법입니다.
계속 읽기 →Dockerfile 빌드 로그에서 문제 원인 빠르게 찾기
Docker 이미지 빌드가 실패했을 때 로그만 보고 원인을 좁히는 방법을 정리했습니다.
계속 읽기 →API Rate Limit 응답 형식이 일관성 없을 때 확인 순서
Rate limit 응답이 일관되지 않을 때 상태 코드와 응답 본문을 점검하는 방법을 정리했습니다.
계속 읽기 →Next.js 정적 생성 배포 후 화면이 다를 때 확인 순서
정적 생성으로 배포한 후 로컬과 운영에서 화면이 다르게 보일 때 원인을 찾는 방법입니다.
계속 읽기 →로컬 개발 DB가 파일을 열 수 없을 때 권한 확인 순서
로컬 개발 환경에서 데이터베이스 파일 접근 문제가 생겼을 때 원인을 빠르게 찾는 방법을 정리했습니다.
계속 읽기 →Next.js Route Handler 배포 전 확인 체크리스트
Route Handler를 배포하기 전에 로컬 테스트와 운영 환경 검증 순서를 정리했습니다.
계속 읽기 →Next.js에서 SEO 메타데이터 관리하기
Next.js의 동적 페이지에서 검색 엔진이 올바른 메타데이터를 인식하려면, 빌드와 배포 단계를 제대로 이해해야 합니다.
계속 읽기 →인터넷 검색으로 찾은 해결책 검증하기
StackOverflow나 GitHub이슈에서 찾은 해결 방법이 정말 자신의 문제에 맞는지 확인해야 합니다. 무분별하게 따라 하면 다른 문제가 생길 수 있습니다.
계속 읽기 →데이터가 사라졌을 때 대응
사용자가 만든 데이터가 갑자기 없어졌거나 다른 값으로 바뀌었다면, 삭제 로직, 캐시, 또는 동시성 문제를 의심해야 합니다.
계속 읽기 →배포 후 네트워크 연결 확인
로컬에서는 잘 되는데 배포 후 API 호출이 실패하면, 네트워크 경로의 어디가 막혔는지 차례대로 확인해야 합니다.
계속 읽기 →systemd 서비스가 시작 안 될 때
개인 프로젝트를 서버에서 자동으로 실행하려고 systemd 서비스를 만들었는데, 시작해도 바로 죽거나 로그에 에러만 뜹니다.
계속 읽기 →개발 환경 설정이 먹지 않을 때
로컬에서 환경 변수나 포트를 설정했는데 앱이 인식하지 못하면, 어느 단계에서 문제가 생겼는지 확인해야 합니다.
계속 읽기 →로그인이 풀렸을 때 원인 찾기
사용자가 갑자기 로그인 상태를 잃으면 세션, 토큰, 쿠키 중 어디가 문제인지 확인해야 합니다.
계속 읽기 →리스트 렌더링이 느릴 때 확인할 것
큰 리스트를 표시하면 브라우저가 느려지는데, 원인은 렌더링, 네트워크, 또는 이벤트 핸들러일 수 있습니다.
계속 읽기 →React에서 상태 업데이트 제대로 디버깅하기
React의 상태 업데이트가 기대대로 안 되면 화면만 봐서는 알 수 없습니다. 로그와 상태 변화를 함께 봐야 합니다.
계속 읽기 →캐시가 꼬일 때 확인하는 순서
캐시는 성능 최적화인데 자주 버그의 원인이 됩니다. 로컬에선 잘 되는데 배포 후 깨지는 이유를 찾는 방법입니다.
계속 읽기 →낙관적 업데이트 제대로 하는 방법
사용자는 즉시 피드백을 받아야 하는데, 낙관적 업데이트를 잘못하면 데이터 불일치 문제가 생깁니다.
계속 읽기 →운영 중 에러 좁히는 체계
운영 환경에서 문제가 생겼을 때 원인을 빠르게 찾는 방법을 정리했습니다.
계속 읽기 →