디스코드 역할이 지급되지 않을 때 해결법

인증 버튼은 눌렸고 봇도 응답했는데 역할만 안 붙으면, 새 멤버 입구가 그 자리에서 막힙니다.

이 문제는 권한 일반론보다 역할 계층과 대상 역할 관리 가능 범위를 먼저 봐야 훨씬 빠릅니다.

이 글은 역할 지급 실패만 따로 떼어, 왜 Manage Roles만 보고 끝내면 안 되는지 정리하는 글입니다.

기본 권한 구조는 디스코드 봇 권한 설정법, 50013과 50001을 막는 기본 구조 정리와 디스코드 역할 설정 완벽 가이드, 관리자 운영진 멤버 봇 역할을 처음부터 정리하는 법을 같이 보면 흐름이 잘 맞습니다.

1. 역할 지급 실패는 거의 항상 계층부터 본다

이 문제가 가장 흔합니다.

봇 역할이 지급하려는 대상 역할보다 아래에 있으면 Manage Roles 권한이 있어도 역할 지급이 실패합니다.

예를 들어 아래 구조는 문제가 생길 수 있습니다.

관리자
운영진
멤버
봇

봇이 `멤버` 역할을 주려면 봇 역할이 그 위에 있어야 합니다.

2. 봇 역할에 Manage Roles가 있는지 확인한다

권한이 빠져 있으면 역할 순서가 맞아도 실패합니다.

서버 역할 설정에서 봇 역할의 Manage Roles를 확인합니다.

이 권한을 켰다고 끝나는 것은 아닙니다.

문제가 생긴 채널에서 봇이 막혀 있지 않은지도 같이 봅니다.

3. 지급 대상 역할이 관리 불가능한 역할인지 본다

관리자 역할처럼 너무 높은 역할, 통합 구조상 직접 만지지 않게 설계한 역할은 봇이 건드리지 못하게 두는 경우가 많습니다.

운영 설계상 일부 역할은 봇 지급 대상에서 빼야 합니다.

초반 서버라면 인증됨, 멤버, 알림수신 정도를 자동 지급 대상으로 두면 무난합니다.

4. 코드에서 역할 ID를 잘못 잡는 경우도 있다

테스트 서버에서 복사한 역할 ID를 운영 서버 코드에 그대로 둔 경우가 흔합니다.

이 경우 봇은 역할을 못 찾거나 엉뚱한 역할을 참조합니다.

역할 이름으로 찾는 방식도 이름이 겹치면 꼬이기 쉽습니다.

가능하면 역할 ID를 정확히 확인합니다.

5. 버튼 인증이나 반응 역할은 이벤트가 실제로 들어오는지도 본다

역할 지급 함수 자체는 맞는데 이벤트가 안 들어와서 지급이 안 되는 경우가 있습니다.

버튼, 모달, 반응 역할은 트리거가 다르기 때문에 이벤트 로그를 같이 찍어 봐야 합니다.

역할 지급 문제처럼 보여도 실제로는 이벤트 미수신일 수 있습니다.

6. 점검 코드 예시

역할을 실제로 찾는지부터 확인하는 로그는 아래 정도면 충분합니다.

role = interaction.guild.get_role(ROLE_ID)

if role is None:
    await interaction.response.send_message("대상 역할을 찾지 못했습니다.", ephemeral=True)
    return

await interaction.user.add_roles(role)
await interaction.response.send_message(f"{role.name} 역할을 지급했습니다.", ephemeral=True)

`role is None`이면 ID부터 다시 봐야 합니다.
역할은 찾는데 지급이 안 되면 순서와 권한 쪽입니다.

7. 이런 경우를 특히 많이 본다

• 봇 역할이 멤버보다 아래에 있는 경우
• Manage Roles를 안 켠 경우
• 잘못된 역할 ID를 넣은 경우
• 테스트 서버와 운영 서버 역할 구조가 다른 경우

처음에는 거의 항상 첫 번째나 세 번째에서 걸립니다.

8. 임시로 관리자 권한을 줘도 역할 순서 문제는 남는다

이 부분을 많이 놓칩니다.

관리자 권한을 줘도 역할 계층 문제는 그대로 남을 수 있습니다.

그래서 문제 확인용으로 권한을 넓혀도 역할 위치는 따로 봐야 합니다.

9. 역할 지급만 안 되는지, 더 넓은 권한 문제인지 가른다

역할 지급만 유독 안 된다면 이 글처럼 역할 계층과 역할 ID를 끝까지 보는 게 맞습니다.

메시지 삭제나 채널 수정까지 전반적으로 실패한다면 Missing Permissions(50013) 오류 해결법 쪽이 더 넓은 진단이고, 인증 입구 전체 권한표를 다시 보고 싶다면 디스코드 봇 권한 설정법, 50013과 50001을 막는 기본 구조 정리와 디스코드 역할 설정 완벽 가이드, 관리자 운영진 멤버 봇 역할을 처음부터 정리하는 법을 같이 보면 자연스럽습니다.