Discord机器人临时封禁如何操作datetime实现重启后自动解封？

核心datetime能力说明 #

1. 时间加减计算解封时间 #

使用内置timedelta类可直接对datetime对象做时长叠加，无需手动换算时间戳：

from datetime import datetime, timedelta, UTC

# 获取带UTC时区的当前时间，和discord.py内部时间体系完全对齐，无兼容问题
ban_start_time = datetime.now(UTC)
# 叠加封禁时长得到解封目标时间，支持同时传入天、小时、分钟、秒级参数
unban_deadline = ban_start_time + timedelta(days=1, hours=2, minutes=30)

注意：必须使用带UTC时区的datetime对象，不要使用无时区标记的裸本地时间对象，否则跨时区部署、服务器时间自动校准后会出现时间校验偏差，甚至直接抛出类型比较错误

2. 到期校验与时间差计算 #

两个带相同UTC时区标记的datetime对象可直接做大小比较，时间差值直接通过减法计算即可得到剩余等待时长：

current_time = datetime.now(UTC)
# 直接比较判断是否到了解封时间
if current_time >= unban_deadline:
    # 触发解封逻辑
# 计算距离解封的剩余秒数
remaining_seconds = (unban_deadline - current_time).total_seconds()

持久化改造解决重启丢任务问题 #

结合上述datetime能力，对原有临时封禁逻辑做最小改造即可解决重启中断问题：

• 每次触发临时封禁时，在执行user.ban()后，把以下信息持久化到本地SQLite、JSON文件等轻量存储中：
  • 被封禁用户ID
  • 所属服务器ID
  • 计算好的unban_deadline（直接转成ISO格式字符串存储，读取时用datetime.fromisoformat()即可还原成datetime对象，无需手动格式转换）
• 机器人启动时，先从持久化存储加载所有未完成的临时封禁记录，不依赖内存中的异步任务
• 后台常驻轮询调度任务，逻辑为：
  1. 遍历所有存储的临时封禁记录，和当前UTC时间做对比，对已到期的记录直接执行解封操作，删除对应的存储条目
  2. 计算距离最近一条待解封记录的时间差，作为下一次轮询的等待间隔，同时设置最长30分钟的兜底轮询周期，避免异常情况漏处理
  3. 没有待处理临时封禁记录时，按固定5分钟间隔轮询一次即可

存储时优先直接存计算好的解封时间点，不要冗余存储“封禁开始时间+封禁时长”字段，减少重复计算带来的误差。

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