디스코드 봇 초대 후 오프라인으로 보일 때 해결법

디스코드 봇을 서버에 초대했는데 목록에는 보이지만 회색 점으로 오프라인 상태인 경우가 있습니다.

이 상황은 초대한 것과 실행한 것이 별개라는 점을 놓칠 때 특히 자주 나옵니다.

대부분은 코드보다 실행 환경이나 토큰, 권한 쪽에서 원인이 잡힙니다.

초대는 끝났는데 오프라인으로 보인다면 아래 순서대로 봐야 가장 빠릅니다.

1. 초대와 실행은 다른 단계다

봇을 서버에 초대했다고 해서 자동으로 켜지지는 않습니다.

초대는 서버에 앱을 등록한 것이고, 실제 온라인 상태는 코드가 실행 중이어야 생깁니다.

입문 단계에서는 이 부분에서 많이 막힙니다.

기본 실행 구조가 아직 없다면 파이썬 디스코드 봇 만들기 처음부터 끝까지, discord.py 입문 가이드나 discord.js v14 디스코드 봇 만들기 처음부터 끝까지를 먼저 다시 봐야 합니다.

2. 터미널에서 코드가 실제로 켜져 있는지 확인한다

가장 먼저 할 일입니다.

프로그램이 실행 중이 아니라면 디스코드에서는 오프라인으로만 보입니다.

보통은 아래 명령어로 실행합니다.

python main.py

node main.js

터미널이 바로 종료되거나 오류가 나오면 그 문제부터 해결해야 합니다.

3. 토큰이 비어 있거나 잘못됐는지 확인한다

.env를 쓰는 구조라면 토큰이 비어 있어도 봇이 조용히 종료될 수 있습니다.

재발급한 새 토큰을 넣지 않은 경우도 흔합니다.

아래를 먼저 봅니다.

• .env 파일 위치가 맞는가
• 변수 이름이 코드와 같은가
• 복사한 토큰이 최신 값인가

토큰 관리 기본 구조는 .env 환경변수로 디스코드 토큰 숨기기, 하드코딩 없이 안전하게 관리하는 법에서 먼저 정리했습니다.

4. client.run() 또는 client.login()이 실제로 호출되는지 본다

코드는 켜졌는데 로그인 함수가 호출되지 않으면 봇은 온라인이 되지 않습니다.

파일 맨 아래 실행 구문이 빠져 있는 경우도 생각보다 자주 나옵니다.

파이썬 예시는 아래처럼 끝나야 합니다.

client.run(TOKEN)

JS 예시는 아래처럼 끝납니다.

client.login(token);

이 한 줄이 빠지면 아무리 코드가 길어도 봇은 오프라인입니다.

5. 터미널 오류 로그를 먼저 읽는다

오프라인 문제는 디스코드 화면보다 터미널이 더 중요합니다.

아래 오류가 자주 나옵니다.

• Invalid Token
• PrivilegedIntentsRequired
• 패키지 import 실패
• .env 읽기 실패

화면상으로는 그냥 오프라인처럼 보여도, 실제 원인은 대부분 터미널에 그대로 나옵니다.

6. 서버에 초대만 되고 권한이 부족한 것은 다른 문제다

권한 부족이면 온라인은 되지만 기능이 안 됩니다.

오프라인 상태는 보통 로그인 자체가 안 된 것입니다.

그래서 오프라인 문제를 볼 때는 먼저 실행, 토큰, 로그인 함수부터 봐야 합니다.

권한 문제는 디스코드 봇 권한 설정법, 50013과 50001을 막는 기본 구조 정리로 따로 보면 빠릅니다.

7. 로컬 PC를 끄면 다시 오프라인이 된다

초대 후 잠깐만 켜 두고 노트북을 닫으면 봇은 다시 오프라인으로 돌아갑니다.

입문 단계에서 아까는 켜졌는데 지금은 왜 꺼졌지가 여기서 자주 나옵니다.

상시 온라인 상태를 원하면 결국 계속 켜져 있는 서버가 필요합니다.

8. 체크리스트로 보면 빠르다

• 실행 명령어를 실제로 돌렸는가
• 터미널이 종료되지 않고 유지되는가
• 토큰 값이 비어 있지 않은가
• client.run() 또는 client.login()이 있는가
• PC를 끄거나 절전 상태로 두지 않았는가

이 다섯 가지로 대부분 정리됩니다.

9. 배포 단계까지 같이 봐야 끝난다

개발이 끝났는데 자꾸 오프라인으로 돌아간다면 로컬 실행만으로는 한계가 있습니다.

운영용 봇은 결국 상시 실행 환경으로 옮겨야 합니다.

배포가 필요한 시점이라면 24시간 디스코드 봇 무료 호스팅, 디스호스트처럼 별도 서버에 올려 둬야 현실적입니다.

10. 오프라인 문제 뒤에는 초대 링크 상태를 점검한다

오프라인 문제를 해결했다면 다음에는 초대 링크 자체가 만료되거나 작동하지 않는 문제를 점검하는 흐름이 자연스럽습니다.

지금 단계에서 토큰이나 실행 구조를 더 보고 싶다면 .env 환경변수로 디스코드 토큰 숨기기, 하드코딩 없이 안전하게 관리하는 법과 초대 링크 추적 디스코드 봇 만들기을 같이 보면 됩니다.