Discord.js开发kick命令时出现hasPermission非函数报错
Discord.js KICK指令权限校验报错修复
报错根因
你遇到的TypeError: message.author.hasPermission is not a function 本质是调用了不存在于对应对象上的方法:
message.author是Discord平台的全局用户对象(User实例),仅存储用户通用账号信息(用户名、头像、公开ID等),不携带任何服务器内的成员身份、权限数据,本身不存在hasPermission相关的权限校验方法。- 权限校验逻辑是绑定在*服务器成员对象(
GuildMember实例)*上的,这个实例代表当前用户在具体某台服务器内的专属身份状态。
正确实现流程
核心调整思路
将原代码中基于全局用户对象的错误校验,替换为基于当前消息所在服务器成员实体的权限判断,整体逻辑分两步:
- 拦截私信场景的指令调用(私信环境下不存在服务器成员实体,本来也无法执行踢人类服务器操作)
- 获取指令调用者的服务器成员实例,校验其是否持有
KICK_MEMBERS权限
适配主流版本的校验代码
针对当前主流使用的Discord.js v13、v14长期支持版本,可直接用如下代码替换报错的原有片段:
// 拦截私信发起的无效调用 if (!message.guild) return; // 校验指令发起者的踢人权限 if (!message.member.permissions.has(PermissionFlagsBits.KickMembers)) return;
注意:使用这段代码前,需要先从discord.js模块导入
PermissionFlagsBits常量,否则会触发未定义变量的报错。
如果你还在使用已经停止维护的Discord.js v12及更早历史版本,对应的校验写法为if (!message.member.hasPermission("KICK_MEMBERS")) return,这类旧版本存在已知安全漏洞,不建议继续投入生产使用。
开发避坑提示
- 权限校验需要双向核对:除了检查指令发起者的权限,还要确认机器人自身在服务器内的角色层级高于被踢目标、且本身持有踢人权限,否则即使校验流程通过,实际踢人操作也会被Discord官方接口拦截。
- 不要通过角色名称反查用户权限:如果用户自行修改了带“管理员”字样的普通角色名,靠名称匹配的逻辑会直接出现权限绕过,始终使用官方提供的权限位校验接口才是最稳妥的方案。
内容的提问来源于stack exchange,提问作者Kian
相关产品推荐
相关产品推荐

