Discord Python Rewrite搭建JSON权限系统时触发KeyError异常
KeyError异常的核心产生原因
- 键类型不匹配导致的判断逻辑失效:JSON规范强制要求存储的对象键必须是字符串,因此从
perms.json读取出的权限字典,所有用户ID格式的键都是字符串类型。而代码中用于判断和索引的message.author.id是Discord API返回的整数类型,二者类型不一致,导致if message.author.id in perms判断永远为False,流程直接进入else分支。 - 不存在的字典键直接访问子字段:进入else分支后,代码没有先为当前用户创建对应的权限字典条目,就直接执行
perms[message.author.id]["owner"] = False的操作。因为整数格式的用户ID根本不是字典中存在的键,自然会抛出对应ID值的KeyError。 - 冗余的重复IO操作:else分支内重复打开同一个权限文件读取内容,和分支外的读取操作完全重复,没有实际作用,还会造成不必要的资源开销。
修复实现方案
- 统一权限表的键类型:所有涉及用户ID的索引操作,都将
message.author.id转为字符串格式,和JSON存储的键格式保持对齐,确保存在性判断准确生效。 - 新增用户权限条目时先初始化结构:当用户ID未在权限表中时,先为该用户创建包含
owner、admin字段的基础权限结构,再执行赋值写回操作,避免直接访问不存在的键。 - 移除重复的文件读取逻辑,文件打开时指定
encoding='utf-8'避免Windows环境下的中文乱码问题。
修复后的参考代码:
@client.event async def on_message(message): if message.author.bot: return # 统一使用字符串格式的用户ID作为权限表键 user_perm_key = str(message.author.id) with open('./perms.json', 'r', encoding='utf-8') as f: perms = json.load(f) # 不存在用户权限条目时先初始化默认权限 if user_perm_key not in perms: perms[user_perm_key] = { "owner": False, "admin": False } # 初始化完成后写回权限文件 with open('./perms.json', 'w', encoding='utf-8') as f: json.dump(perms, f, sort_keys=True, ensure_ascii=False, indent=4)
注意:实际使用中可以给权限文件的读写增加简单的异常捕获,避免权限文件损坏、不存在时导致机器人整体崩溃。
内容的提问来源于stack exchange,提问作者RaphielHS
相关产品推荐
相关产品推荐

