使用Pickle序列化Discord Bot的ReactionRole对象时遇TypeError报错

问题原因 #

你碰到的TypeError: cannot pickle 'TaskStepMethWrapper' object错误，本质是因为你试图保存的emoji_var是Discord的Emoji或PartialEmoji对象——这类对象内部包含了和异步任务绑定的引用（也就是那个TaskStepMethWrapper），而Pickle无法处理这种带有复杂内部状态的非原生Python对象。

解决方案 #

我们不需要保存整个Emoji对象，只需要存储能唯一识别它的信息即可。下面给你三种可行的方案，你可以根据需求选择：

方案1：修改reactionrole类，存储可序列化的Emoji信息

这是最贴合你现有代码的方案，只需要调整类的初始化逻辑，把Emoji对象转换成基本数据类型存储：

import discord
import pickle
import os

class reactionrole:
    def __init__(self, msgid, emoji, roleid):
        self.msgid = msgid
        self.roleid = roleid
        # 区分自定义表情和Unicode表情，存储可序列化的信息
        if isinstance(emoji, discord.PartialEmoji):
            self.is_custom_emoji = True
            self.emoji_id = emoji.id
            self.emoji_name = emoji.name
            self.emoji_animated = emoji.animated
        else:
            self.is_custom_emoji = False
            self.emoji_char = str(emoji)
    
    # 可选：添加方法，从存储的信息重建Emoji对象
    def get_emoji(self, client):
        if self.is_custom_emoji:
            return client.get_emoji(self.emoji_id)
        else:
            return self.emoji_char

@client.command()
async def reactionadd(ctx):
    await ctx.send('Please react with the emoji you want the reactionrole to use.')
    emoji_var = await client.wait_for('reaction_add')
    emoji_var = emoji_var[0]

    # 读取现有数据
    rrobj = []
    if os.path.isfile('reactionrole.obj') and os.stat('reactionrole.obj').st_size != 0:
        with open('reactionrole.obj', 'rb') as rrf:
            rrobj = pickle.load(rrf)
    
    # 添加新的reactionrole实例
    rrobj.append(reactionrole(749316751212150965, emoji_var, 749317419255857232))
    
    # 保存数据
    with open('reactionrole.obj', 'wb') as rrf:
        pickle.dump(rrobj, rrf)

方案2：换成JSON序列化（更安全、易读）

Pickle存在代码执行风险（如果加载了恶意生成的pickle文件），如果想让数据更安全或可读，可以用JSON。同样需要把Emoji转成字典存储：

import discord
import json
import os

class reactionrole:
    def __init__(self, msgid, emoji, roleid):
        self.msgid = msgid
        self.roleid = roleid
        # 序列化Emoji信息为字典
        if isinstance(emoji, discord.PartialEmoji):
            self.emoji_data = {
                "type": "custom",
                "id": str(emoji.id),
                "name": emoji.name,
                "animated": emoji.animated
            }
        else:
            self.emoji_data = {
                "type": "unicode",
                "char": str(emoji)
            }
    
    @classmethod
    def from_dict(cls, data):
        """从字典重建reactionrole实例"""
        instance = cls(data["msgid"], None, data["roleid"])
        instance.emoji_data = data["emoji_data"]
        return instance
    
    def to_dict(self):
        """把实例转换成字典"""
        return {
            "msgid": self.msgid,
            "roleid": self.roleid,
            "emoji_data": self.emoji_data
        }

@client.command()
async def reactionadd(ctx):
    await ctx.send('Please react with the emoji you want the reactionrole to use.')
    emoji_var = await client.wait_for('reaction_add')
    emoji_var = emoji_var[0]

    # 读取现有数据
    rrobj = []
    if os.path.exists('reactionrole.json') and os.path.getsize('reactionrole.json') > 0:
        with open('reactionrole.json', 'r', encoding='utf-8') as f:
            data_list = json.load(f)
            rrobj = [reactionrole.from_dict(item) for item in data_list]
    
    # 添加新实例
    rrobj.append(reactionrole(749316751212150965, emoji_var, 749317419255857232))
    
    # 保存数据
    with open('reactionrole.json', 'w', encoding='utf-8') as f:
        json.dump([item.to_dict() for item in rrobj], f, indent=2)

方案3：手动读写文本文件（极简方案）

如果不想用类的复杂逻辑，也可以用简单的文本格式存储，每行记录msgid,emoji_info,roleid：

import discord
import os

@client.command()
async def reactionadd(ctx):
    await ctx.send('Please react with the emoji you want the reactionrole to use.')
    emoji_var = await client.wait_for('reaction_add')
    emoji_var = emoji_var[0]

    # 处理Emoji为字符串
    if isinstance(emoji_var, discord.PartialEmoji):
        emoji_str = f"{emoji_var.id}:{emoji_var.name}:{emoji_var.animated}"
    else:
        emoji_str = str(emoji_var)
    
    # 追加写入文本文件
    with open('reactionrole.txt', 'a', encoding='utf-8') as f:
        f.write(f"749316751212150965,{emoji_str},749317419255857232\n")

# 读取文本文件的示例代码
def load_reaction_roles():
    rrobj = []
    if os.path.exists('reactionrole.txt'):
        with open('reactionrole.txt', 'r', encoding='utf-8') as f:
            for line in f:
                line = line.strip()
                if not line:
                    continue
                msgid_str, emoji_str, roleid_str = line.split(',', 2)
                msgid = int(msgid_str)
                roleid = int(roleid_str)
                # 解析Emoji信息
                if ':' in emoji_str:
                    emoji_id_str, name, animated_str = emoji_str.split(':', 2)
                    emoji_data = {
                        "id": int(emoji_id_str),
                        "name": name,
                        "animated": animated_str == 'True',
                        "is_custom": True
                    }
                else:
                    emoji_data = {
                        "char": emoji_str,
                        "is_custom": False
                    }
                rrobj.append({"msgid": msgid, "emoji": emoji_data, "roleid": roleid})
    return rrobj

方案选择建议 #

• 如果想继续用Pickle，选方案1，改动最小，兼容性最好；
• 如果在意数据安全或可读性，选方案2，JSON是更通用的序列化格式；
• 如果只需要极简的存储方式，选方案3，代码最直观。

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