Discord.py中JSON文件额外添加括号致排行榜命令无法读取求助

阿华AIGC实验室

2026-5-8

问题根源分析

你遇到的JSON文件损坏问题，核心原因是使用了r+模式打开文件却没有正确处理原有内容，再加上全局计数对象没有从文件初始化，导致写入时出现内容残留或数据不一致的情况。

具体来说：

r+是"读写"模式，打开文件时指针位于开头，但json.dump()只会从当前指针位置开始写入新内容。如果新生成的JSON字符串长度比文件中原有的内容短，未被覆盖的旧内容会留在文件末尾，最终形成格式错误的JSON（比如你看到的多余括号）。
你的全局dict = Counter()在机器人启动时是空的，没有从users.json加载已有数据——这不仅会导致重启后数据丢失，还会让每次写入的内容和文件实际存储的不一致，进一步加剧格式损坏的问题。

修复方案

我们需要从两个核心点入手修复：改用安全的文件写入模式，以及保证每次操作都基于文件中的最新数据。

1. 修正`cupcake`命令的文件操作逻辑

改用w模式打开文件（会先清空原有内容再写入），同时在机器人启动时从文件加载已有数据，确保计数对象始终和文件内容同步。

修正后的代码：

from collections import Counter
import json
import discord
from discord.ext import commands

# 初始化时从文件加载数据，没有文件则创建空Counter
def load_cupcake_data():
    try:
        with open('users.json', 'r') as f:
            # 将JSON对象转为Counter类型
            return Counter(json.load(f))
    except FileNotFoundError:
        # 文件不存在时返回空计数器
        return Counter()

# 全局计数对象，启动时加载已有数据
user_cupcakes = load_cupcake_data()

@commands.command()
async def cupcake(self, ctx):
    user_id = str(ctx.author.id)  # 你原代码里的user变量未定义，这里修正为ctx.author
    # 更新用户的cupcake计数
    user_cupcakes[user_id] += 1
    # 用w模式写入，清空文件后写入最新完整数据
    with open('users.json', 'w') as f:
        # Counter转为普通dict再序列化（JSON不直接支持Counter类型）
        json.dump(dict(user_cupcakes), f)

2. 优化`top`命令的排序与展示逻辑

你的top命令存在几个小问题：pass_context=True在新版discord.py中已无需使用；直接用字典存储排序结果可能丢失顺序（虽然Python3.7+字典保留插入顺序，但用列表更稳妥）；还有变量名拼写错误。

修正后的代码：

@commands.command()
async def top(self, ctx):
    with open('users.json', 'r') as fg:
        data = json.load(fg)
    # 排序后得到有序列表，避免字典顺序问题
    top_cakes = sorted(data.items(), key=lambda item: item[1], reverse=True)
    names = ''
    # 从1开始计数排名，同时解构用户ID和计数
    for position, (user_id, count) in enumerate(top_cakes, start=1):
        names += f'{position}. <@!{user_id}> has {count} cupcakes\n'
    # 处理空数据的情况
    if not names:
        names = "No one has any cupcakes yet!"
    embed = discord.Embed(title="Cupcake Top", color=0xF9CF7A)
    embed.add_field(name="Top Bakers:", value=names, inline=False)
    await ctx.send(embed=embed)