Missing Permissions(50013) 오류 해결법

/청소는 눌렸는데 메시지가 안 지워지고, 역할 지급 명령어도 응답은 오는데 실제 작업만 실패하면 거의 이 오류를 의심하게 됩니다.

핵심은 "봇이 죽은 것"이 아니라 "작업 권한만 부족한 것"이라는 점입니다.

이 글은 접근은 되는데 행동만 막히는 50013 상황을 빠르게 가르는 데 집중합니다.

1. 들어가기는 되는데 행동만 막히는 상태다

이 오류는 봇이 어떤 작업을 수행할 권한이 부족하다는 뜻입니다.

채널에 접근 자체를 못 하는 문제와는 결이 다릅니다.

접근은 되지만 행동 권한이 부족한 상태라고 보면 됩니다.

예를 들어 아래 작업에서 자주 보입니다.

• 메시지 삭제
• 역할 지급 또는 제거
• 닉네임 변경
• 타임아웃 부여

2. 봇 역할 자체에 권한이 있는지 본다

가장 먼저 서버 역할 화면에서 봇 역할을 확인합니다.

해당 작업에 맞는 권한이 실제로 켜져 있어야 합니다.

예를 들어 메시지 삭제라면 Manage Messages, 역할 지급이라면 Manage Roles가 필요합니다.

코드에서 명령어를 잘 짜도 역할 권한이 없으면 바로 50013으로 끝납니다.

기본 권한표가 아직 흔들린다면 디스코드 봇 권한 설정법과 디스코드 역할 설정 완벽 가이드, 관리자 운영진 멤버 봇 역할을 처음부터 정리하는 법을 같이 열어 둬야 빠릅니다.

3. 채널 덮어쓰기에서 다시 막히는지 확인한다

서버 역할 권한을 켜도 채널에서 막혀 있으면 작업이 실패할 수 있습니다.

로그 채널, 공지 채널, 특정 문의 채널에서 자주 나옵니다.

서버 권한만 보고 끝내지 말고, 문제가 발생한 채널의 덮어쓰기까지 같이 확인합니다.

4. 역할 지급 계열은 역할 순서를 먼저 본다

50013에서 가장 자주 놓치는 부분입니다.

봇 역할이 대상 역할보다 아래에 있으면 Manage Roles를 갖고 있어도 역할 지급이 실패합니다.

예시는 아래처럼 정리합니다.

관리자
운영진
봇
인증됨
멤버

봇이 `멤버`나 `인증됨` 역할을 주게 할 계획이라면 봇 역할이 그 위에 있어야 합니다.

5. 명령어 실행자 권한도 함께 볼 필요가 있다

봇 권한만 충분해도 안 되는 경우가 있습니다.

코드에서 명령어 실행자에게도 manage_messages=True 같은 조건을 걸어 두었다면 유저 권한이 부족할 수 있습니다.

즉, 아래 둘을 나눠서 봅니다.

• 봇이 해당 작업을 할 권한이 있는가
• 명령어를 실행한 유저가 그 명령어를 호출할 권한이 있는가

6. 빠른 점검 예시

메시지 삭제 명령어가 실패한다면 아래 순서가 빠릅니다.

1. 봇 역할에 Manage Messages가 있는가
2. 해당 채널에서 봇 역할이 차단되지 않았는가
3. 명령어 실행자에게 메시지 관리 권한이 있는가
4. 봇이 정말 그 채널을 보고 있는가

역할 지급 명령어라면 마지막에 역할 순서 확인이 추가됩니다.

7. 테스트 코드로 권한을 확인하는 방법

아래처럼 현재 채널 기준 권한을 찍어 보면 빠릅니다.

@bot.command(name="권한체크")
async def permission_check(ctx):
    permissions = ctx.channel.permissions_for(ctx.guild.me)
    await ctx.send(
        "\n".join(
            [
                f"manage_messages={permissions.manage_messages}",
                f"manage_roles={permissions.manage_roles}",
                f"view_channel={permissions.view_channel}",
                f"send_messages={permissions.send_messages}",
            ]
        )
    )

채널마다 결과가 다를 수 있으니 문제가 생긴 채널에서 직접 실행합니다.

8. 관리자 권한으로 임시 확인만 하고 끝내지 말 것

문제 원인을 찾겠다고 봇에 Administrator를 잠깐 주는 경우가 있습니다.

원인 분리 용도로는 쓸 수 있지만 그대로 운영하는 것은 추천하지 않습니다.

무엇이 부족했는지 끝까지 확인하고 다시 최소 권한 구조로 되돌려야 합니다.

9. 50013인지 50001인지 헷갈릴 때 갈라보는 순서

채널이나 대상 자체가 안 보인다면 50013보다 디스코드 채널이 안 보일 때 권한 해결법 쪽이 먼저일 수 있습니다.

반대로 역할 지급만 유독 안 되면 디스코드 역할 설정 완벽 가이드, 관리자 운영진 멤버 봇 역할을 처음부터 정리하는 법으로 역할 계층부터 다시 보고, 기본 권한표부터 다시 확인하고 싶다면 디스코드 봇 권한 설정법을 먼저 다시 맞춰야 빠릅니다.