如何在discord.py机器人中实现按指定日期拉取Discord频道历史消息功能

问题解答 #

1. 针对Q1：TextChannel类提供了异步方法history()，专门用于拉取频道的历史消息，不需要自行获取全量消息再过滤，该方法本身就支持传入时间参数筛选消息。
2. 针对Q2：你之前的用法不符合工具定位，discord.utils.get的作用是从一个可迭代对象里匹配符合指定属性的单个对象，不支持按时间范围过滤，也没有from这个筛选参数，完全不适合这个场景。

正确实现思路 #

• 传入的频道ID要转成整数类型，discord的ID均为int类型，参数如果定义为字符串需要先做类型转换，否则discord.utils.get无法找到对应频道
• 日期参数建议转成datetime.datetime对象，注意要带时区信息，优先使用UTC时间避免时区错乱
• 调用channel.history()时直接传after=from_date参数即可拉取指定日期之后的所有消息，也可搭配before参数限定时间范围，加limit参数限制拉取的消息数量，limit设为None会拉取全部符合条件的消息
• 该方法是异步迭代器，可以用async for遍历每一条消息，也可以用flatten()方法直接转成消息列表

完整示例代码 #

import discord
from discord.ext import commands
from datetime import datetime

# 注意要开启机器人的Message Content Intent权限，且配置足够的网关意图
bot = commands.Bot(command_prefix='!', intents=discord.Intents.all())

@bot.command(name='fetchmessages', help='拉取指定频道指定日期后的消息，参数格式：频道ID 日期(YYYY-MM-DD)')
async def fetchmessages(ctx, from_channel_id: str, from_date_str: str):
    # 转换频道ID为整数
    try:
        channel_id = int(from_channel_id)
    except ValueError:
        await ctx.send("频道ID格式错误，请输入数字ID")
        return
    
    # 获取频道对象并校验类型
    channel = discord.utils.get(ctx.guild.channels, id=channel_id)
    if not channel or not isinstance(channel, discord.TextChannel):
        await ctx.send("未找到对应文本频道")
        return
    
    # 解析日期为带UTC时区的时间对象
    try:
        from_date = datetime.strptime(from_date_str, "%Y-%m-%d")
        from_date = from_date.replace(tzinfo=datetime.timezone.utc)
    except ValueError:
        await ctx.send("日期格式错误，请使用YYYY-MM-DD格式")
        return
    
    # 拉取消息并做自定义处理
    messages = []
    async for message in channel.history(after=from_date, limit=None):
        # 此处可替换为你自己的业务逻辑
        messages.append(f"{message.author.name}: {message.content}")
    
    # 示例：返回结果到调用频道
    if messages:
        # discord单条消息最长2000字符，此处做截断处理
        await ctx.send("\n".join(messages[:2000]))
    else:
        await ctx.send("该时间段内没有找到消息")

注意事项 #

• 确保机器人拥有目标频道的「查看频道」「查看消息历史」权限，否则无法拉取消息
• 如果拉取的消息量很大，注意做好分批处理，避免触发接口限流

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