turin's blog

만들고, 터지고, 기록합니다

풀스택, Flutter, 서버 운영, SEO, 배포 삽질을 실제 프로젝트 기준으로 정리합니다. 검색해서 들어온 사람이 바로 쓸 수 있는 체크리스트와 명령을 남기는 게 목표입니다.

1175published
8topics
kopractical notes

자주 다루는 주제

주제별로 빠르게 훑어보기

웹 개발350Next.js283서버 운영165Docker110API80TypeScript58DB50Flutter39

전체 글

운영 중 부딪힌 문제를 검색 의도에 맞춰 정리

Next.js

Next.js에서 에러 페이지를 볼 때 먼저 확인할 로그

Next.js 프로덕션 서비스에서 에러 페이지가 보일 때 실제 에러가 뭔지 찾기 위해 로그를 읽고 원인을 파악하는 방법을 정리했다.

·4분 읽기
Next.js3분 읽기

Next.js 배포할 때 캐시로 인한 문제를 피하는 방법

Next.js 애플리케이션 배포 후 이전 버전의 캐시가 남아서 구버전이 계속 보이는 문제를 디버깅하고 해결하는 방법을 다룬다.

계속 읽기 →
API3분 읽기

REST API에서 JSON 응답이 이상할 때 확인할 것

REST API에서 JSON 응답 형식이 예상과 다르거나 파싱 에러가 날 때 상태 코드, 본문, 인코딩을 확인하는 체크리스트를 정리했다.

계속 읽기 →
서버 운영3분 읽기

서버 백업에 접속할 수 없을 때 확인할 순서

데이터베이스 백업 저장소나 백업 스토리지에 접속이 안 될 때 네트워크, 권한, 저장소 문제를 체계적으로 진단하는 방법을 정리했다.

계속 읽기 →
웹 개발3분 읽기

데이터베이스 시드(seed) 데이터를 다룰 때 실수 줄이는 방법

데이터베이스 개발 환경을 셋업할 때 시드 스크립트가 제대로 작동하고 운영에 영향을 주지 않도록 관리하는 방법을 다룬다.

계속 읽기 →
웹 개발3분 읽기

데이터베이스 스키마를 바꾸기 전 확인 순서

SQL 데이터베이스의 스키마를 변경할 때 로컬과 운영 환경의 차이를 고려하고 마이그레이션을 안전하게 진행하는 방법을 정리했다.

계속 읽기 →
API2분 읽기

REST API에서 날짜 필터가 이상할 때 확인할 것

API의 날짜 필터가 예상과 다르게 작동할 때 타임존, 형식, 범위를 체계적으로 확인하는 방법을 정리했다.

계속 읽기 →
Flutter2분 읽기

Flutter로 Android 빌드할 때 막힐 때 원인 좁히는 순서

Flutter의 Android 빌드가 실패했을 때 로그를 읽고 원인을 체계적으로 찾아가는 방법을 정리했다.

계속 읽기 →
Next.js2분 읽기

Next.js에서 canonical URL이 소셜 미리보기를 망칠 때

Next.js의 canonical URL 설정이 잘못돼서 SNS 공유 시 미리보기가 깨지는 경우와 디버깅 과정을 다룬다.

계속 읽기 →
Docker2분 읽기

Docker 멀티스테이지 빌드에서 데이터가 사라지는 이유

Docker의 멀티스테이지 빌드에서 빌드 스테이지의 산출물이 최종 이미지에 복사되지 않는 문제를 다루고 확인하는 방법을 정리했다.

계속 읽기 →
웹 개발2분 읽기

Play Console 앱이 갑자기 느려지면 먼저 볼 것

Google Play Console에 올린 앱의 성능이 저하됐을 때, 배포 전에 확인해야 할 체크리스트를 정리했다.

계속 읽기 →
TypeScript2분 읽기

TypeScript as const 타입을 쓸 때 주의할 점

TypeScript의 as const 표현식을 리팩터링할 때 자주 마주치는 문제와 체계적인 디버깅 순서를 정리했다.

계속 읽기 →
Docker1분 읽기

Next.js 메타데이터 설정, SEO와 소셜 공유 이미지가 제대로 나오게 하기

Next.js에서 메타데이터와 OG 이미지를 올바르게 설정하여 검색 엔진과 소셜 미디어에서 제대로 표시되도록 하는 방법입니다.

계속 읽기 →
서버 운영1분 읽기

HTTPS 인증서 문제, 도메인과 트래픽을 안전하게 관리하기

웹 서버의 HTTPS 인증서 관련 문제를 진단하고 안전하게 수정하는 실전 방법입니다.

계속 읽기 →
Flutter1분 읽기

Flutter 모바일 레이아웃 문제, 혼자 빠르게 디버깅하기

Flutter 개발 중 모바일 레이아웃이 깨지는 문제를 효율적으로 진단하고 해결하는 방법입니다.

계속 읽기 →
Next.js1분 읽기

React 빈 상태 렌더링, 초보자가 자주 놓치는 버그

React에서 데이터가 없을 때의 상태 관리와 렌더링을 올바르게 처리하는 방법을 정리했습니다.

계속 읽기 →
서버 운영1분 읽기

systemd 서비스 문제, 서버 운영에서 빠르게 진단하기

서버 운영 중 systemd 서비스 관련 문제를 발견하고 대응하는 체계적인 절차입니다.

계속 읽기 →
UX1분 읽기

마이그레이션 후 발생하는 UI 버그, 로컬과 배포 환경 비교하기

데이터베이스 마이그레이션이나 주요 리팩토링 후 배포 환경에서만 나타나는 버그를 추적하는 방법입니다.

계속 읽기 →
TypeScript1분 읽기

TypeScript 유니온 타입, 타입 안정성 문제를 체계적으로 풀기

TypeScript에서 유니온 타입을 다룰 때 발생하는 타입 에러를 빠르게 진단하는 방법입니다.

계속 읽기 →
웹 개발1분 읽기

VPS 처음 세팅할 때 포트 충돌 문제 빠르게 해결하기

새 서버에서 포트가 이미 사용 중이라고 나올 때 원인을 찾고 대응하는 실전 방법입니다.

계속 읽기 →
웹 개발1분 읽기

목록 렌더링 성능 문제, 초보자가 자주 놓치는 부분

React에서 리스트를 렌더링할 때 성능 저하와 버그를 유발하는 실수들을 정리했습니다.

계속 읽기 →
웹 개발1분 읽기

배포 후 발견되는 버그, 로컬과 운영 환경 차이 대응

개발 환경에서는 문제가 없는데 배포되면 버그가 나타나는 상황에서 원인을 찾는 체계적인 방법입니다.

계속 읽기 →
웹 개발1분 읽기

데이터베이스 연결 문제, 환경별로 달라지는 이유

웹 개발에서 로컬과 배포 환경의 연결 문제를 구분하고 빠르게 해결하는 방법을 정리했습니다.

계속 읽기 →
Next.js1분 읽기

React 상태 관리 디버깅, 혼자 할 때 빠르게 원인 찾기

혼자 React 프로젝트를 개발할 때 상태 관리 문제를 빠르게 진단하는 실전 팁을 정리했습니다.

계속 읽기 →