본문 바로가기

전체 글189

챗GPT 블로그 글쓰기, AI 티 줄이는 프롬프트와 수정 전후 예시 챗GPT로 초안을 만들면 문장은 매끄러운데 내 글 같지 않을 때가 있습니다. “현대 사회에서”, “매우 중요합니다” 같은 문장이 반복되고, 정작 독자가 궁금한 해결 방법은 뒤로 밀리기도 하죠. 이런 경우에는 자연스럽게 써 달라는 말만 반복하기보다 독자·사실·말투·수정 범위를 구체적으로 알려주는 편이 좋습니다.이 글에서 얻는 것: 자연스러운 글을 만드는 재료부터 실제로 적용할 수 있는 예시와 확인 방법까지 정리했습니다.1. 자연스러운 글을 만드는 재료글을 맡기기 전에 세 가지를 적어 보세요. 누가 읽는지, 무엇을 해결해 주는지, 직접 확인한 사실은 무엇인지입니다. “개발 블로그 글 작성”보다 “처음 배포하는 사람이 환경변수 위치를 확인하도록 돕는 글”이 편집 기준을 잡기 쉽습니다.OpenAI의 공식 프롬프.. 2026. 10. 4.
Next.js Hydration failed 오류 원인과 해결 방법 Hydration failed 오류는 서버가 만든 HTML과 브라우저의 첫 렌더 결과가 맞지 않을 때 발생합니다. 무조건 useEffect를 추가하기보다 어떤 값이나 HTML 구조가 달라졌는지 찾는 것이 먼저입니다. 새로고침할 때만 나타나는 오류도 이 관점으로 점검할 수 있습니다.적용 범위: Next.js App Router · TypeScript 예제. 2026년 9월 공식 문서 확인 기준이며, 프로젝트 버전과 렌더링 설정에 따라 오류 문구는 달라질 수 있습니다.1. 비교 대상은 브라우저의 첫 렌더서버가 만든 초기 화면에 React가 이벤트와 상태를 연결하는 과정이 hydration입니다. 서버에서 “기본 테마”를 만들었는데 브라우저 첫 렌더에서 localStorage를 읽어 “다크 테마”를 출력하면 .. 2026. 10. 4.
Next.js NEXT_PUBLIC_ 환경변수 차이 정리 NEXT_PUBLIC_은 환경변수를 어디서 읽을 수 있는지 결정하는 중요한 표시입니다. API 주소가 안 읽힌다는 이유로 모든 변수에 붙이면 비밀키까지 브라우저로 전달할 수 있습니다. 공개 여부와 값이 결정되는 시점을 함께 이해해야 합니다.적용 범위: Next.js App Router · TypeScript 예제. 2026년 9월 공식 문서 확인 기준이며, 프로젝트 버전과 렌더링 설정에 따라 오류 문구는 달라질 수 있습니다.1. 일반 환경변수와 공개 환경변수일반 환경변수는 서버에서 사용하고, NEXT_PUBLIC_이 붙은 변수는 브라우저 코드에서도 참조할 수 있습니다. 공개 API 주소나 분석용 공개 ID는 후보가 되지만, 데이터베이스 비밀번호·결제 서비스 비밀키·관리자 인증 토큰은 공개 변수로 만들면 .. 2026. 10. 3.
Next.js .env.local 적용 안 될 때 확인할 것 Next.js에서 .env.local을 만들었는데 값이 undefined라면 파일을 다시 만들기 전에 읽는 위치부터 확인하세요. 서버에서 읽는 값인지, 브라우저에서 읽는 값인지에 따라 원인이 달라집니다. 이 글은 환경변수가 아예 없거나 예전 값으로 나오는 상황을 순서대로 점검하는 가이드입니다.적용 범위: Next.js App Router · TypeScript 예제. 2026년 9월 공식 문서 확인 기준이며, 프로젝트 버전과 렌더링 설정에 따라 오류 문구는 달라질 수 있습니다.1. 파일 위치와 이름부터 확인하기.env.local은 Next.js 앱의 루트, 일반적으로 package.json 옆에 둡니다. src를 쓰더라도 src 안으로 옮기지 않습니다. 모노레포에서는 저장소 전체의 루트와 실제 Next... 2026. 10. 2.
Next.js useSearchParams() Suspense 오류 해결 방법 개발 서버에서는 잘 열리던 페이지가 배포 빌드에서 useSearchParams() should be wrapped in a suspense boundary 오류로 멈출 때가 있습니다. 정적 페이지에서 쿼리스트링을 읽는 컴포넌트를 분리하고, 그 컴포넌트 바깥에 Suspense를 두는 방법부터 확인하면 됩니다.적용 범위: Next.js App Router · TypeScript 예제. 2026년 9월 공식 문서 확인 기준이며, 프로젝트 버전과 렌더링 설정에 따라 오류 문구는 달라질 수 있습니다.1. 개발할 때는 되는데 빌드에서 실패하는 이유예를 들어 /search?q=react의 q를 읽는 검색창을 생각해 보겠습니다. 빌드 시점에는 방문자가 입력할 쿼리를 알 수 없습니다. 정적 렌더링에서는 해당 훅을 사용하.. 2026. 10. 1.
Next.js use client는 언제 붙여야 할까 Next.js App Router에서 useState나 onClick을 추가하자 오류가 생겼다면 use client 경계를 확인해 보세요. 페이지 전체에 습관적으로 붙이기보다, 실제로 상호작용이 필요한 컴포넌트를 작게 분리하면 구조를 이해하고 유지하기 쉬워집니다.적용 범위: Next.js App Router · TypeScript 예제. 2026년 9월 공식 문서 확인 기준이며, 프로젝트 버전과 렌더링 설정에 따라 오류 문구는 달라질 수 있습니다.1. use client는 클라이언트 진입점 선언App Router의 page와 layout은 기본적으로 Server Component입니다. 상태, 이벤트, effect가 필요한 UI를 Client Component로 만들 때 파일의 import보다 위에 us.. 2026. 9. 30.
반응형