npm install을 실행했는데 갑자기 터미널이 빨간 글씨로 도배되는 경험, 해본 적 있는가? error engine Unsupported engine error Found: [email protected] error Required: node@^18.0.0 error at /Users/dev/project-a/package.json 지난달에 정확히 이 상황을 겪었다. 회사 레거시 프로젝트는 Node.js 18을 요구하고, 사이드 프로젝트에서 쓰던 Next.js 15는 Node.js 20 이상이 필요했다. Homebrew로 설치한 Node.js는 시스템 전체에 딱 하나의 버전만 유지하니까, 프로젝트를 … 더 읽기
iPad 하나로도 본격적인 코딩 환경을 구축할 수 있다. 2년 전만 해도 이 문장을 진지하게 받아들이는 개발자는 드물었다. 하지만 GitHub Codespaces가 브라우저 기반 VS Code 환경을 안정적으로 제공하면서 상황이 달라졌다. 나는 출장이 잦은 편인데, 노트북 대신 iPad Air + Magic Keyboard 조합으로 코드 리뷰와 간단한 기능 수정을 처리한 지 6개월이 넘었다. 로컬 개발 환경 세팅 없이 … 더 읽기
녹화 버튼을 눌렀는데 미리보기가 까만 화면이라면, 당황스러울 수밖에 없다. OBS Studio 30.x를 설치하고 소스를 추가했는데 프리뷰 창이 칠흑 같은 검정색 — 나도 macOS Sonoma 14.4로 업데이트한 직후에 이 상태를 처음 겪었고, 거의 40분을 날렸다. 소스 설정 문제인지, 권한 문제인지, 아니면 Apple Silicon GPU 호환성 문제인지 원인이 여러 갈래라서 더 혼란스럽다. 이 글에서는 macOS Sonoma 14.x와 … 더 읽기
페이지 로딩 시간이 3초를 넘기면, 방문자의 53%가 이탈한다는 통계가 있다. Google의 2024년 Core Web Vitals 보고서에 따르면 모바일 사용자의 기대 로딩 시간은 2.5초 이하이고, LCP(Largest Contentful Paint) 기준 2.5초를 충족하는 워드프레스 사이트는 전체의 33%에 불과하다. 나도 운영하던 블로그의 PageSpeed Insights 점수가 모바일 기준 28점까지 떨어진 적이 있는데, 아래 과정을 거치고 나서 82점까지 끌어올렸다. 한 번에 … 더 읽기
사이트에 접속했더니 하얀 화면만 나온다. 어제까지 잘 되던 사이트가 갑자기 먹통이 된 거다. 관리자 페이지(wp-admin)도 열리지 않고, 500 에러만 반복되는 상황. 이런 일이 보통 새벽에 터진다. 자동 업데이트가 돌아간 직후, 혹은 플러그인 하나를 무심코 업데이트한 뒤에. 나도 운영 중인 워드프레스 사이트에서 두 번이나 이 상황을 겪었는데, 처음엔 호스팅 문제인 줄 알고 업체에 문의부터 했다. 결론부터 … 더 읽기
Application Passwords는 WordPress 5.6부터 도입된 REST API 인증 방식이다. 기존에는 쿠키 인증이나 OAuth 플러그인 없이는 외부에서 WordPress API를 호출하기가 꽤 번거로웠는데, 이 기능 덕분에 별도 플러그인 설치 없이도 HTTP Basic Auth 기반의 API 연동이 가능해졌다. 나는 자동 포스팅 시스템을 구축하면서 이 기능을 처음 사용했는데, 세팅 자체는 5분이면 끝나지만 HTTPS 문제나 플러그인 충돌 때문에 예상보다 시간을 … 더 읽기
Cron Trigger가 예상대로 실행되지 않을 때, 순서대로 점검하면 대부분 원인을 찾을 수 있다. 이 글은 내가 실제로 Cloudflare Workers의 Cron Trigger를 운영하면서 겪었던 문제들을 체크리스트 형태로 정리한 것이다. wrangler.toml 설정 실수부터 UTC 타임존 혼동, scheduled() 핸들러 누락까지 — 한 항목씩 따라가다 보면 어디서 막혔는지 금방 파악할 수 있을 거다. 📑 목차 증상부터 확인하기 wrangler.toml [triggers] … 더 읽기
Workers에서 환경변수를 다룰 때, 로컬과 프로덕션의 차이를 간과하는 경우가 많다. env.API_KEY를 콘솔에 찍어보면 undefined가 떡하니 나오고, 분명 대시보드에서 설정했는데 왜 안 되는 건지 한참을 헤맸던 경험 — 아마 Workers 개발자라면 한 번쯤 겪어봤을 거다. 로컬에서는 잘 되다가 배포만 하면 터지는 경우, 반대로 프로덕션에서는 되는데 wrangler dev에서만 안 되는 경우, 심지어 둘 다 안 되는 경우까지. … 더 읽기
Cloudflare Pages는 정적 사이트 배포에 최적화된 플랫폼이다. 커스텀 도메인을 연결하는 과정에서 SSL 인증서 관련 오류를 만나면 꽤 당황스럽다. 분명 DNS 설정도 했고, 도메인도 연결했는데 브라우저에 빨간 자물쇠가 뜨면서 ERR_SSL_VERSION_OR_CIPHER_MISMATCH 에러가 화면을 채울 때의 그 막막함이란… 배포는 성공했는데 사이트에 접속이 안 되는 상황, 생각보다 자주 발생한다. 이 문제는 대부분 Cloudflare의 SSL/TLS 설정과 DNS 레코드 구성이 맞물려 … 더 읽기
$ curl -X POST https://example.com/wp-json/wp/v2/posts \ -H “Content-Type: application/json” \ -d ‘{“title”:”테스트 포스트”,”status”:”draft”}’ HTTP/1.1 401 Unauthorized { “code”: “rest_cannot_create”, “message”: “Sorry, you are not allowed to create posts as this user.”, “data”: { “status”: 401 } } WordPress REST API를 처음 연동할 때 거의 100% 마주치는 응답이다. 나도 자동 포스팅 스크립트를 처음 만들던 날, 이 … 더 읽기