DiscordJS v14 封禁命令报错：类型验证失败问题排查

核心原因 #

你遇到的CombinedError本质是**setDefaultMemberPermissions方法的参数类型不匹配**。DiscordJS v14对该方法的参数有严格的类型限制：

• 仅允许传入null、undefined，或是BigInt类型的权限位（比如BigInt(0)表示无权限，PermissionsBitField.Flags.BanMembers对应的原生BigInt值）
• 错误日志里的Expected undefined or null、Expected a bigint primitive直接说明你传入了不符合要求的类型（比如普通数字、字符串、错误的权限对象）

常见错误场景及修复方案 #

结合你的ban.js代码，以下是最可能触发错误的场景和修复方式：

场景1：传入普通数字而非BigInt #

错误写法：

// 错误：使用number类型的权限值
.setDefaultMemberPermissions(2048)

修复：转成BigInt，或直接用DiscordJS提供的权限常量（本身就是BigInt）

// 写法1：用BigInt包裹数字
.setDefaultMemberPermissions(BigInt(2048))

// 写法2：使用PermissionsBitField常量（推荐）
const { PermissionsBitField } = require('discord.js');
.setDefaultMemberPermissions(PermissionsBitField.Flags.BanMembers)

场景2：传入PermissionsBitField对象而非其值 #

错误写法：

// 错误：直接传入PermissionsBitField实例
.setDefaultMemberPermissions(new PermissionsBitField(['BanMembers']))

修复：取实例的value属性（BigInt类型）

.setDefaultMemberPermissions(new PermissionsBitField(['BanMembers']).value)

场景3：传入字符串或其他无效类型 #

错误写法：

// 错误：传入字符串类型的权限名称
.setDefaultMemberPermissions('BanMembers')

修复：改用正确的BigInt值或权限常量

场景4：设置全员不可用时传入0而非BigInt(0) #

错误写法：

// 错误：使用number类型的0
.setDefaultMemberPermissions(0)

修复：

// 用BigInt(0)表示无权限
.setDefaultMemberPermissions(BigInt(0))
// 或传null表示继承频道原有权限
.setDefaultMemberPermissions(null)

验证步骤 #

1. 打开ban.js找到setDefaultMemberPermissions的调用行
2. 检查传入参数的类型，确保是null、undefined或BigInt
3. 修正后重新运行node deploy-commands.js和node init.js

补充说明 #

DiscordJS v14在命令注册阶段的类型校验非常严格，所有涉及权限位的参数必须是BigInt——这是v14和旧版本的关键区别之一，旧版本允许使用number类型，升级后很容易踩这个坑。

内容的提问来源于stack exchange，提问作者delta