Privileged Intents not enabled 오류 해결법

디스코드 봇을 실행했는데 Privileged Intents not enabled 경고나 오류가 뜨면 대부분 Portal 설정과 코드 설정이 어긋난 상태입니다.

명령어가 안 먹히거나 이벤트가 아예 안 들어오는 경우가 같이 나타날 수 있습니다.

접두사 명령어, 멤버 이벤트, 상태 추적 기능을 붙일수록 자주 보게 되는 문제입니다.

이 오류는 이름만 보면 어렵게 느껴지지만 확인할 위치는 생각보다 단순합니다.

1. Privileged Intents가 무엇인가

디스코드가 민감도가 높은 일부 이벤트를 별도 허용 항목으로 분리해 둔 것입니다.

대표적으로 아래 항목이 자주 나옵니다.

• Message Content Intent
• Server Members Intent
• Presence Intent

입문 단계에서는 보통 Message Content Intent부터 많이 만납니다.

2. 코드에서 켰다고 끝이 아니다

많이 하는 실수가 여기 있습니다.

코드에서 인텐트를 켜 두어도 Developer Portal에서 허용하지 않으면 오류가 납니다.

예시는 아래와 같습니다.

intents = discord.Intents.default()
intents.message_content = True
intents.members = True

이렇게만 적어 두고 Portal에서 체크하지 않으면 그대로 막힙니다.

3. Portal에서 켜는 위치

Discord Developer Portal에서 애플리케이션을 연 뒤 Bot 메뉴로 들어갑니다.

아래로 내리면 Privileged Gateway Intents 구간이 나옵니다.

여기서 필요한 항목을 켜고 저장합니다.

저장 버튼을 누르지 않고 닫는 경우도 생각보다 많습니다.

4. 어떤 기능이 어떤 인텐트를 쓰는지 구분한다

모든 기능에 모든 인텐트가 필요한 것은 아닙니다.

필요 없는 인텐트까지 무조건 켜 둘 이유도 없습니다.

대략 아래처럼 보면 됩니다.

!핑 같은 메시지 명령어 -> Message Content Intent
멤버 입장/퇴장 감지 -> Server Members Intent
상태 정보 추적 -> Presence Intent

처음에는 필요한 것만 정확히 켜야 합니다.

5. 코드는 맞는데 이벤트가 안 들어올 때

에러가 길게 안 나와도 이벤트가 조용할 수 있습니다.

특히 on_message, on_member_join 같은 이벤트가 전혀 안 들어오면 인텐트부터 먼저 봅니다.

초반에는 코드 디버깅보다 인텐트 확인이 더 빠른 경우가 많습니다.

6. 빠른 점검 예시

아래 둘을 같이 확인합니다.

1. 코드에서 해당 intent를 True로 켰는가
2. Developer Portal의 Bot 메뉴에서 같은 intent를 켰는가

둘 중 하나라도 빠지면 오류가 납니다.

7. Message Content Intent와 가장 자주 연결된다

입문자 기준으로는 거의 여기서 걸립니다.

!핑, !도움, 자동 응답, 키워드 감지 기능은 대부분 메시지 본문을 읽어야 합니다.

그래서 Privileged Intents not enabled는 사실상 Message Content 설정 누락으로 많이 체감됩니다.

세부 흐름은 Message Content Intent 설정법, 디스코드 봇이 명령어를 읽지 못할 때 먼저 볼 것에서 더 자세히 정리해 두었습니다.

8. 필요 없는 인텐트까지 무조건 켜지 말 것

문제가 생겼다고 전부 다 켜 버리는 경우가 있습니다.

당장은 편해 보여도 나중에 왜 이 이벤트를 받는지 스스로 설명하기 어려워집니다.

필요 기능 기준으로만 켜야 운영과 디버깅 둘 다 낫습니다.

9. 다음 단계

인텐트 설정까지 맞췄는데도 메시지 명령어가 안 읽힌다면 다시 접두사 구조와 봇 재시작 여부를 봐야 합니다.

서버 권한 쪽까지 함께 점검하려면 디스코드 봇 권한 설정법, 50013과 50001을 막는 기본 구조 정리을 이어서 확인하면 됩니다.