산책하는 댕발자

Connection lost: The server closed the connection 에러 해결

github.com/zlrloy — Wed, 3 Jun 2026 22:06:13 +0900

에러

API 호출시 500 에러가 났고 서버 로그는 The server closed the connection 메시지가 반복적으로 나타나고 있었다.

SequelizeConnectionError: Connection lost: The server closed the connection.

해당 에러에는 다양한 원인이 있을 수 있는데,

필자는 무료 체험판 크레딧이 모두 소진되면서 GCP Cloud SQL 인스턴스가 자동으로 정지되면서 DB 연결에 오류가 발생한 것이다.

failed to connect to instance:
fetch ephemeral cert failed:
googleapi: Error 409:
The instance or operation is not in an appropriate state to handle the request.
invalidState

해결

팀원에게 상황을 공유한 후 GCP 결제 계정을 업그레이드하고 Cloud SQL 인스턴스를 다시 활성화했다.

업그레이드 완료 후 Cloud SQL 인스턴스가 정상 상태로 복구되었고 모든 기능이 정상 동작했다.

[PM2] ENOSPC: no space left on device, write 에러 해결 (log 용량 비우기)

github.com/zlrloy — Tue, 12 May 2026 08:02:51 +0900

갑자기 서버에 CORS 에러가 났다.

PM2 로그($pm2 logs)를 확인해보니

Error: ENOSPC: no spase left on device, write

/home/ubuntu/.pm2/logs/api-error.log last 15 lines:
api      |       throw er; // Unhandled 'error' event
api      |       ^
api      |
api      | Error: ENOSPC: no space left on device, write
api      | Emitted 'error' event at:
api      |     at WriteStream.<anonymous> (/home/ubuntu/calvak-api/node_modules/file-stream-rotator/FileStreamRotator.js:697:15)
api      |     at WriteStream.emit (node:events:390:28)
api      |     at WriteStream.emit (node:domain:475:12)
api      |     at emitErrorNT (node:internal/streams/destroy:157:8)
api      |     at emitErrorCloseNT (node:internal/streams/destroy:122:3)
api      |     at processTicksAndRejections (node:internal/process/task_queues:83:21) {
api      |   errno: -28,
api      |   code: 'ENOSPC',
api      |   syscall: 'write'
api      | }

원인은 디스크 용량 부족.

write가 있는거 보니 무언가를 파일에 쓰려고 했으나 실패했나보다.

디스크 용량 확인

디스크가 얼마나 꽉 차 있는지 확인해보자.

df -h

# 결과
Filesystem      Size  Used Avail Use% Mounted on
/dev/root        15G   15G  3.5M 100% /

디스크가 100% 꽉 차 있었다.

남은 용량은 3.5M

 
서버는 요청이 올 때마다 요청로그, 에러로그, DB쿼리로그 등을 디스크 파일로 계속 기록한다.
 
서버는 요청이 올 때마다

요청 로그

에러 로그

DB 쿼리 로그

이걸 디스크 파일로 계속 기록합니다.

그래서 로그가 많으면 디스크가 금방 찹니다.

로그 용량 확인하기

어떤 로그가 문제인지 용량을 확인해보자.

ls -lh ~/.pm2/logs

여기서 로그 파일 크기를 보면 된다.

-rw-r--r-- 1 ubuntu ubuntu 8.2G api-out.log
-rw-r--r-- 1 ubuntu ubuntu 4.1G api-error.log

몇 GB 크기의 로그 파일이 확인된다면,
디스크 용량을 상당 부분 차지하고 있는 원인으로 의심할 수 있다.

로그 비우기 (삭제X)

로그 파일은 삭제보다 내용만 비우는 방식이 안전하다.

위에서 큰 용량을 차지하는 파일 내용을 비워준다.

truncate -s 0 ~/.pm2/logs/npm-start-out.log

truncate -s 0: 파일 크기를 0바이트로 줄인다. (파일 유지하고 내용만 비움)

디스크 확인

다시 디스크를 확인해보자.

df -h

# 이전
Filesystem  Size  Used Avail Use% Mounted on
/dev/root 15G 15G 3.5M 100%

# 로그 정리 후
/dev/root 15G 8G 7G 53%

서버는 정상화되었고, 로그 기록도 다시 정상 동작했다.

결론: 서버는 멀쩡했고 로그가 너무 열심히 일한 탓

명령어 정리

- 디스크 상태 확인

df -h

- 어떤 폴더가 용량 먹는지 확인

du -sh /*

- PM2 로그 확인

ls -lh ~/.pm2/logs

- 로그 비우기

truncate -s 0 ~/.pm2/logs/api-error.log

[Watch Face Studio] 갤럭시워치7 워치페이스 다운로드 및 설정

github.com/zlrloy — Sun, 10 May 2026 22:31:43 +0900

기분전환하듯 워치 배경을 바꾸는 편인데 워치페이스가 조금 심심하게 느껴져 마음에 드는 스타일을 다운받아 설정해보았다.

다운로드한 워치페이스를 직접 적용하고 원하는 스타일로 워치를 꾸며보자

1. 휴대폰 설정

1-1. 설정 > 워치 정보

1-2. 개발자모드 활성화

소프트웨어 정보 > 소프트웨어 버전을 5번 연속 클릭

1-3. 블루투스 OFF

워치를 Wi-Fi로 연결해 다운로드한 워치페이스를 적용하기 위해서 블루투스를 잠시 비활성화한다.

1-4. 노트북과 같은 와이파이인지 확인

를 꾸욱 눌러 현재 연결된 와이파이와 노트북 와이파이 일치 확인

2. 워치 페이스 스튜디오 다운로드

2-1. 다운로드

아래 링크에서 각 OS에 맞게 다운로드한다.

워치 페이스 스튜디오 다운로드 | Samsung Developer

The world runs on you.

developer.samsung.com

⚠️ "열 수 없습니다." 오류 발생시

시스템 설정 > 보안 및 개인 정보 보호 > 일반에서 "확인된 개발자가 등록한 응용 프로그램이 아니기 때문에 ‘WatchFaceStudio.pkg’를 사용할 수 없도록 차단했습니다." 옆에 있는 확인 없이 열기을 클릭한다.
"macOS가 WatchFaceStudio.pkg의 개발자를 확인할 수 없습니다. 그래도 여시겠습니까?"라는 메시지 창이 나타나면 "열기"를 클릭해 워치 페이스 스튜디오를 설치한다.

다운로드 받고 실행하면 아래와 같은 화면이 뜬다.

2-2. 프로젝트 열기

다운받은 wfs를 선택한다.

2-3. 내 위치에 적용하기

오른쪽 상단에 'Run on Device' 클릭

+ 클릭하여 내 워치정보 입력하기

IP: IP 주소 (000.00.0.00) - 무선디버깅에서 확인

IP port: 포트 (00000) - 무선디버깅에서 확인

Pairing code: Wi-Fi 페어링 코드 - 새 기기 등록 > 기기페어링 확인

Pairing port: 포트 (00000) - 새 기기 등록 > 기기페어링 확인

입력정보는 워치에서 확인 가능하다, ADB 디버깅과 무선 디버깅을 켜준다.

무선 디버깅 활성화 → IP 주소 및 포트 확인 → 000.00.0.00:00000 → IP, IP port 입력

새 기기 등록 클릭 → Wi-Fi 페어링 코드와 포트 확인 → Pairing code, Pairing port 입력

작성 후 OK를 누르면 워치가 등록된다.

등록된 Watch7를 누르고 20초 정도 대기하면 워치페이스 전송 완료!

참고

https://blog.naver.com/jdm333/223755595991

[PM2] .env NODE_APP_INSTANCE 환경변수가 안먹힌 이유

github.com/zlrloy — Sun, 10 May 2026 21:17:11 +0900

PM2로 Node 서버를 띄우고 있었던 프로젝트에 스케줄링(cron)을 돌리는 로직을 추가하면서

cron을 제어하기 위해 .env에 환경변수를 설정해두었는데

설정을 미실행으로 해놔도 cron이 돌아가고 있었다.

cron 설정 코드

if (process.env.NODE_APP_INSTANCE === '0') {
    cron.schedule('0 * * * *', expiredEmailVerification, cronOption);
}

NODE_APP_INSTANCE === "0" → cron 실행
!= "0" → cron 미실행

.env 설정 (cron 미실행을 위한)

NODE_APP_INSTANCE=1

이렇게 하면 조건문에 걸리지 않으니까 cron이 실행되지 않을 거라고 생각했다.

그런데…

logs를 보니 스케줄링이 정상적으로 실행중이었다. 1시간마다 정확히 로그가 찍히고 있었다.

2026-05-10 13:00:00 [INFO] : 만료된 인증 요청이 없습니다.
2026-05-10 14:00:00 [INFO] : 학교 이메일 인증 만료 처리 완료: 1명 반려

스케줄링을 꺼놨는데 왜 돌아가지???

먼저 환경변수 로딩이 정상적으로 되고 있는지 콘솔을 찍어봤다.

const cron = require("node-cron");
const cronOption = { scheduled: true, timezone: "Asia/Seoul"};

console.log('INSTANCE:', process.env.NODE_APP_INSTANCE);

if (process.env.NODE_APP_INSTANCE === '0') {
    console.log('cron 등록됨');

    cron.schedule('0 * * * *', expiredEmailVerification, cronOption);
    } else {
    console.log('cron 스킵됨');
}

결과

INSTANCE: 0
cron 등록됨

.env에 1로 설정했는데 왜 0일까?

원인

NODE_APP_INSTANCE는 내가 설정한 .env의 환경변수이면서 PM2 내부 환경변수이기도 하다.

아래 명령어를 치면 확인할 수 있다.

pm2 env 0

결과

그래서 아무리 프로젝트의 env에서 값을 1로 지정하더라도 PM2 env 값으로 덮어쓰기 때문에 내가 설정한 값은 실제 실행 환경에서 무시되고 있었던 것이다.

왜?

PM2에서 단일 인스턴스로 실행하면 PM2는 자동으로 환경변수 NODE_APP_INSTANCE를 0으로 설정한다.

PM2는 클러스터 모드에서 프로세스 번호를 식별해야 해서 내부적으로 환경변수를 자동 생성한다.

프로세스 값	프로세스 번호
instance 1	0
instance 2	1
instance 3	2

NODE_APP_INSTANCE는 PM2 전용 내부 변수에 가깝다. (개발자가 제어하는 변수 X)

해결

NODE_APP_INSTANCE를 직접 제어하려 하지 말고 cron 전용 환경변수를 새로 만들었다.

.env

CRON_ENABLED=true

코드 수정

if (process.env.CRON_ENABLED === 'true') {
    cron.schedule('0 * * * *', expiredEmailVerification, cronOption);
}

이제는 PM2와 충돌할 일이 없이 스케줄링이 정상적으로 제어가 가능해졌다!

[Kakao Developers] 카카오 로그인 설정 (REST API 키 생성)

github.com/zlrloy — Fri, 2 Jan 2026 10:20:20 +0900

1. 카카오 개발자 콘솔 접속

https://developers.kakao.com/

Kakao Developers

카카오 API를 활용하여 다양한 어플리케이션을 개발해 보세요. 카카오 로그인, 메시지 보내기, 친구 API, 인공지능 API 등을 제공합니다.

developers.kakao.com

해당 링크에 접속해 카카오 계정으로 로그인한다.

2. 앱 생성

① 앱 - 앱 생성 클릭

② 앱 이름 / 회사명 / 카테고리 입력 후 저장

3. REST API 키 확인

앱 - 플랫폼 키에서

REST API 키
JavaScript 키
Native 앱 키를 확인할 수 있다.

서버에서 카카오 로그인을 구현할 때 REST API 키를 사용한다.

4. Redirect URI 등록

카카오 로그인 성공 후 돌아올 주소를 등록한다.

web 서버

REST API 키 - 앱 - 앱 설정 - 앱 - 플랫폼 키 - 플랫폼 키 수정

https://developers.kakao.com/docs/latest/ko/kakaologin/prerequisite

Kakao Developers

카카오 API를 활용하여 다양한 어플리케이션을 개발해 보세요. 카카오 로그인, 메시지 보내기, 친구 API, 인공지능 API 등을 제공합니다.

developers.kakao.com

5. Client Secret 설정

카카오 로그인 사용 ON으로 활성화한다.

참고. 활성화하지 않을 경우 KOE004 에러가 발생한다.

참고

https://ddonghyeo.tistory.com/16#1.%20%EC%B9%B4%EC%B9%B4%EC%98%A4%20%EB%A1%9C%EA%B7%B8%EC%9D%B8%20%EC%9A%94%EC%B2%AD-1

2025 개발회고

github.com/zlrloy — Wed, 31 Dec 2025 22:21:43 +0900

고마웠던 2025년, 개발자로서의 첫 해

Keep

1년만에 이직해 개발팀으로 입사했다. 합격 소식을 들었을 때의 기분은 아직도 생생하다. 엄청 기쁘면서도 얼떨떨했다.

기술 스택이 맞는 공고가 많지 않았는데 다행히 유일하게 맞았던 곳에 입사했고 어느덧 6개월 차가 되었다.

개발은 여전히 어렵다. 해결되지 않는 문제를 만나면 평생 안 풀릴 것처럼 막막해지고, 어느 순간 해결되면 또 마음이 잔잔해진다.

이 감정의 반복이 개발의 묘미인 것 같다. 역시 취준할 때도 겪어봤지만 엉덩이 붙이고 끝까지 파고들면 결국 해결하지 못할 문제는 없다는 것, 이건 앞으로도 변하지 않을 것이다.

업무적으로는 첫 프로젝트에서 프론트엔드 개발자와 통신하면서 발생했던 에러와 예외 사항들을 모두 정리해두었다가 다음 프로젝트에 그대로 참고하면서 통신 에러가 없도록 했고 QA 수정 사항도 체감상 70% 이상 줄였다.
한 번 겪은 문제를 기록하고 다음 프로젝트에서 반복되지 않도록 기록하는 습관은 앞으로도 계속 유지할 것이다.

역시 기록의 친절함은 날이 갈수록 더 크게 느끼고 있다.

또 팀 내 문서 정리에도 적극적으로 개입했다. 기존 노션을 수정하며 API 명세서 양식, 배포 가이드 등 그동안 명확하게 정리되어 있지 않았던 문서들을 재정비했다. 새로 만드는 것보다는 팀 상황에 맞게 정리하고 다듬는 방향으로 해서 개발 흐름을 파악하는 데에도 도움이 되었다. 프론트엔드 개발자분들이 내가 작성한 API 명세서를 보고 '작업하면서 질문할 게 없다. 필요한 모든 내용이 담겨있어 API 연동 작업할 때 편하다'고 했다. 문서 하나로 협업이 수월해졌다.

개발 외적으로는 조직문화에도 관심을 가지고 참여했다. 이전 회사들에서의 경험을 토대로 신규 입사자의 입장에서 느낄 수 있는 불편함이나 아쉬운 점들을 정리해 경영지원팀에 전달했다. 그 결과 현재 실제로 운영되고 있는 복지도 늘고, 팀간의 서먹했던 분위기도 풀어졌다.

지금은 신규 입사자들이 자연스럽게 그 복지를 누리고 있어 개인적으로 보람을 느낀다. 이게 가능했던 것은 의견에 귀 기울여 주신 팀장님의 열린 마음 덕분이기도 하다. 팀이 더 나아질 수 있는 방향을 함께 고민하는 문화는 앞으로도 계속 지켜가고 싶은 부분이다.

Problem

프로젝트를 진행하면서 가장 어려웠던 점은 회의 내용, 기획서, 피그마를 기준으로 백단에서 로직을 설계하기에 정보가 충분하지 않은 경우가 종종 있었다. 여러 문서를 종합해 개발을 진행하다 보니 구현 단계에서 방향이 모호하거나 디테일한 기획의 부재를 뒤늦게 인지하는 상황이 발생했다. 가끔 개발 도중 방향을 수정해야 했고 그러다보니 일정이 촉박해져 업무를 마감일 끝자락에 간신히 마무리하기도 했다.

기획과 개발 사이에서 발생하는 이 간극을 줄이지 못하면 개발 일정이 딜레이될 수도 있고 업무 집중에도 영향을 주기 때문에 그냥 지나치면 안된다고 생각했다.

Try

1. 앞으로는 개발을 시작하기 전에 불확실한 것들을 꼼꼼하게 체크하고 공유하는 것에 더 집중하려고 한다.

애매한 방향은 체크리스트로 정리하기
구현 전에 애매한 로직은 확실하게 질문하기
앞으로의 프로젝트에서도 같은 질문이 반복되지 않도록 디테일한 기준을 잡아 공유하기

를 시도한다면 일정이 빠듯해져서 막판에 작업이 몰리는 상황을 줄이고 자체 QA도 더 신경쓸 수 있는 방향으로 이끌 수 있을 것 같다.

2. 이 문제에 대해서는 단순히 환경을 아쉬워하기보다는 내 마인드도 바꾸기로 결심했다.

불확실한 상황 자체를 부담으로 받아들이기보다는 문제를 해결하기 위해 어떤 순서로, 어떻게 접근할지 결정하는 능력을 기를 수 있는 기회라고 생각하려 한다. 이러한 경험들이 쌓여 개발자로서의 판단력과 문제 해결 능력을 키우고, 팀과 회사에 더 긍정적인 영향을 줄 있을 것이라 기대해본다.

[AWS] 액세스 키(Access Key) 생성하기

github.com/zlrloy — Mon, 22 Dec 2025 08:21:36 +0900

GitHub Actions로 자동 배포 환경을 셋팅하면서 액세스 키가 필요했다.

액세스 키는 AWS ↔ 외부 시스템을 연결하기 위한 인증 수단이다.

우리가 브라우저로 아이디/비밀번호를 입력해서 AWS 콘솔 로그인하여 직접 AWS를 사용하는 것처럼,

사람이 아닌 프로그램이 AWS를 제어하기 위해서는 아이디/비밀번호 대신 액세스 키+시크릿 키를 사용한다.

액세스 키를 생성하는 방법은 간단하다. AWS 액세스 키 생성 가이드대로만 따라하면 끝!

가이드 문서에 맞춰 하나씩 따라해보자.

https://docs.aws.amazon.com/ko_kr/keyspaces/latest/devguide/create.keypair.html

1. AWS에 로그인 후 IAM 이동

https://console.aws.amazon.com/iam/

2. 사용자 선택

액세스 키 사용자를 선택한다. (없다면 사용자 생성)

3. 액세스 키 만들기

보안 자격 증명 탭에서 액세스 키 만들기 버튼을 누른다.

4. 액세스 키 생성

✔️ 액세스 키 모범 사례 및 대안

용도에 맞는 사례를 선택한다.

✔️ 설명 태그 설정

(선택사항)액세스 키에 대한 설명을 작성한 다음 액세스 키 만들기 버튼을 누른다.

액세스 키 생성 완료!

* 파일로 다운로드하려면 .csv 파일 다운로드를 눌러 안전한 위치에 키를 저장한다.

[Swifty pusher] 푸시 알림 테스트 방법

github.com/zlrloy — Mon, 24 Nov 2025 15:07:03 +0900

Swifty Pusher

푸시 알림 기능을 구현하다 보면 서버 로직은 다 완성했는데 “왜 알림이 안 오지?”하는 상황이 생겼다.

근데 이 문제가 서버인지, iOS 설정인지, APNs 인증 문제인지 판단하기가 쉽지 않다.

이 때 사용하는 도구가 Swifty Pusher다.

Swifty Pusher는 APNs로 직접 푸시 전송을 해볼 수 있는 macOS 전용 테스트 도구이다.
서버를 거치지 않고 iOS 기기에 푸시 알림을 보내 알림이 오지 않으면 어떤 문제인지 파악이 쉬워진다.

푸시 기능은 구현하면서 실제로 디바이스 토큰이 정상적으로 발급된 것인지부터 Swifty Pusher로 먼저 테스트하면서 진행하니 문제 범위를 좀 더 빠르게 좁힐 수 있었다.

푸시 알림 이슈를 빠르게 디버깅하기 위해 Swifty Pusher를 활용해보자!

사용 방법

1️⃣ Swifty Pusher 설치

앱스토어에서 Swifty Pusher를 검색 후 다운로드한다.

2️⃣ APNs 설정 입력

아래 정보들을 입력한다.

Team ID: Apple Developer 계정의 Team ID
Bundle ID: 푸시 받을 iOS 앱의 Bundle Identifier
Key ID: Apple Developer Console에서 생성한 APNs Key ID
Authentication Type: Token Based (*.p8) 방식 선택
Device Token: 테스트할 아이폰의 디바이스 토큰

3️⃣ Payload 작성 후 전송

Payload를 입력 후 Push Notification 버튼을 누른다.

{
  "aps": {
    "alert": {
      "title": "Notification Title",
      "body": "This is the body of push notification"
    },
    "sound": "default"
  }
}

✔️ 창 아래 Status code: 200 (no error)가 표시되고 푸시 알림이 도착한다면? APNs 인증과 iOS 설정은 정상이라는 의미 = 서버 로직쪽에 문제가 있을 가능성이 높다.

✔️ 푸시 알림이 실패한다면? 인증 키, Bundle ID, 환경(Sandbox/Production), 토큰 값 등부터 다시 체크해봐야 한다.

[MySQL] ERROR 1524 (HY000): Plugin 'mysql_native_password' is not loaded 에러 해결

github.com/zlrloy — Sat, 25 Oct 2025 23:51:19 +0900

1년만에 새 프로젝트를 시작했다.

초기 셋팅을 진행하면서 MySQL 로그인을 시도했는데 에러가 났다.

에러메시지: ERROR 1524 (HY000): Plugin 'mysql_native_password' is not loaded

‍ 원인

현재 MySQL 버전은 8.4.3

$ mysql --version
  mysql  Ver 8.4.3 for macos14.7 on arm64 (Homebrew)

MySQL은 8.4부터 mysql_native_password 플러그인이 완전히 제거되었다.
my.cnf에 default_authentication_plugin=mysql_native_password가 설정되어 있었기 때문에 에러가 발생한 것이다.

‍ 해결

1. 파일 수정

nano /opt/homebrew/etc/my.cnf

default_authentication_plugin=mysql_native_password 삭제하거나, 주석 처리를 하고 싶다면 줄 맨 앞에 #를 추가한다.
(예: # default_authentication_plugin=mysql_native_password)

그리고 저장

^X → Y(Yes) → Enter

2. MySQL 서버 종료

mysql.server stop

이렇게 SUCCESS ! 메시지가 뜨면 정상적으로 종료된 것이다.

3. 안전 모드로 서버 실행

/opt/homebrew/opt/mysql@8.4/bin/mysqld_safe --skip-grant-tables &

4. root로 MySQL 접속

mysql -u root

5. 접속 후 root 인증 플러그인을 바꿔준다.

FLUSH PRIVILEGES;
ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY '새 비밀번호';

6. 종료 후 재시작

$ pkill mysqld

2025-10-25T12:55:14.936744Z 0 [System] [MY-013172] [Server] Received SHUTDOWN from user <via user signal>. Shutting down mysqld (Version: 8.4.3).
2025-10-25T12:55:15.695377Z 0 [System] [MY-010910] [Server] /opt/homebrew/opt/mysql@8.4/bin/mysqld: Shutdown complete (mysqld 8.4.3)  Homebrew.
2025-10-25T12:55:15.695398Z 0 [System] [MY-015016] [Server] MySQL Server - end.
[1]  + 55562 done       /opt/homebrew/opt/mysql@8.4/bin/mysqld --skip-grant-tables --skip-networking

mysql.server start

7. 재접속

mysql -u root -p

성공~!

[DBeaver] 컬럼값 NULL로 되돌리기

github.com/zlrloy — Wed, 22 Oct 2025 10:59:01 +0900

DBeaver에서 데이터를 수정하다 보면 셀에 들어있던 값을 지웠는데 값이 아예 없어지는게 아니라 빈 문자열('') 로 바뀌는 경우가 있다.

별 차이 없어 보이지만 실제로 이 차이는 꽤 중요하다.

NULL → 값이 없다
빈 문자열('') → 값은 있는데 글자 길이가 0인 값

그래서, 빈 문자열을 NULL로 되돌리는 방법

간단하다.

DBeaver에서 테이블 데이터 보기 화면으로 들어간다.
NULL로 바꾸고 싶은 셀을 마우스 우클릭한다.
Edit - Set to NULL 선택
저장