봇이 메시지에 반응하지 않아요
위에서부터 차례로 확인하세요. 홈의 봇 상태 위젯과 설정 → 알림, 이벤트 → 문제 해결 도우미가 많은 항목을 대신 점검해 줘요.
- 전역 전원 — 설정 → 일반에서 켜져 있는지 확인해요. 꺼져 있으면 홈 위쪽에 ⚠ 전원: 꺼짐이 보여요.
- 알림 접근 권한 — 설정 → 일반에서 허용됨인지 확인해요. 앱을 업데이트한 뒤 권한이 풀리는 기기도 있으니, 허용됨인데도 안 되면 시스템 설정에서 껐다 켜 보세요.
- 프로젝트 상태 — 프로젝트 카드가 실행 중인지 확인해요. 컴파일 필요라면 컴파일한 뒤 켜요.
- 디버그 룸 — 디버그 룸에서 같은 메시지를 보내 봐요. 여기서도 반응이 없다면 스크립트 문제예요. 조건문과 이벤트 함수 이름을 확인하세요. NeonJS 프로젝트라면 함수 앞에
export가 있어야 해요. - 카카오톡 알림 — 카카오톡 알림이 켜져 있고, 알림에 메시지 내용이 보여야 해요. 채팅방을 열어 두고 있거나 방 알림을 꺼 두었다면 알림이 오지 않아요.
- 받은 메시지 확인 — 설정 → 알림, 이벤트에서 수신 메세지 로그 표시를 켜고, 메시지를 받았을 때 로그에 남는지 봐요. 로그에 없다면 StarLight가 알림을 받지 못하고 있는 거예요.
- 패키지 규칙 — 카카오톡을 듀얼 메신저나 업무 프로필에서 쓴다면 패키지 규칙을 직접 설정해야 해요.
- 받을 이벤트 — 프로젝트 설정의 받을 이벤트에서 메시지 이벤트(
onMessage(event),response(…),bot.on(Event.MESSAGE)중 쓰는 것)가 체크돼 있는지 확인해요.
답장이 가지 않아요
- 로그에 메세지가 수신되지 않은 방 '…' 에 메세지를 보낼 수 없습니다가 보인다면, 앱이 시작된 뒤 그 방에서 메시지를 받은 적이 없는 거예요. 방 이름으로 보내는 API(
Api.replyRoom(),replier.reply(방, 메시지))는 그 방의 알림을 한 번 받은 뒤에 쓸 수 있어요. - 같은 방에서 받은 메시지에 답할 때는
event.room.send()를 쓰는 것이 가장 확실해요. - 앱을 다시 시작하면 방 정보가 비워져요. 다시 시작한 뒤에는 각 방에서 메시지를 한 번 받아야 그 방에 보낼 수 있어요.
프로젝트가 저절로 꺼져요
이벤트 함수에서 처리하지 않은 오류가 나면, 기본 설정에서는 프로젝트가 꺼져요. 로그에서 실행 중 에러 발생을 찾아 원인을 고친 뒤 다시 컴파일하고 켜세요.
- 오류가 나도 프로젝트를 계속 켜 두려면 프로젝트 설정의 오류 발생시 비활성화를 꺼요.
- 앱이 시작될 때 자동 컴파일에 실패한 프로젝트도 꺼져요.
봇이 한동안 동작하다 멈춰요
시스템이 백그라운드에서 StarLight를 종료했을 가능성이 커요.
- 설정 → 일반 → 배터리 최적화 예외를 설정해요.
- 제조사의 절전 기능(삼성의 절전 예외 앱 등)에도 StarLight를 넣어요.
- StarLight 실행중 알림을 끄지 마세요.
봇이 응답하지 않고 멈춰 있어요
스크립트가 끝나지 않는 반복문이나 오래 걸리는 작업에 묶여 있을 수 있어요. 프로젝트 설정의 위험 → 프로젝트 스레드 강제 종료 아래에서 실행 중인 작업과 대기 중인 이벤트 수를 확인하고, 프로젝트를 다시 컴파일하거나 프로젝트 스코프 폐기로 멈추세요.
앱이 시작되자마자 꺼져요
앱이 비정상 종료되면 다음 실행 때 오류 화면이 나와요. 최근에 설치한 플러그인이 원인일 수 있으니 안전 모드로 실행해 플러그인을 지워 보세요.
문제가 계속되면 GitHub 이슈에 로그 파일(StarLight/logs/)과 함께 알려 주세요.