Discord机器人出现heartbeat阻塞警告，是否会导致崩溃？

警告是否会导致机器人崩溃？ #

会，大概率引发连接断开甚至崩溃。Discord网关靠心跳包维持与机器人的连接，如果心跳被阻塞超过阈值（通常30秒），Discord会判定机器人离线，主动断开WebSocket连接；多次出现这类情况，机器人可能因无法重连而彻底崩溃。

问题根源 #

你的example命令里的无限循环直接阻塞了Discord.py的事件循环：

• 无延迟的while True会疯狂占用CPU，完全卡死单线程的事件循环，导致心跳包无法按时发送。
• 同步文件操作（open、os.remove）也会阻塞事件循环，进一步加剧心跳延迟。

修复方案 #

1. 用后台任务替代命令内的无限循环 #

不要在命令里跑无限循环，改用discord.py的tasks.loop装饰器创建后台任务，避免阻塞事件循环：

import discord
from discord.ext import commands, tasks
import os
import json
import asyncio
from config import TOKEN

intents = discord.Intents.default()
intents.members = True
intents.message_content = True
bot = commands.AutoShardedBot(shard_count=2, command_prefix="!", intents=intents)

# 存储目标频道ID，避免重复查找
target_channel_id = None

@bot.event
async def on_ready():
    print(f'Logged in as {bot.user} (ID: {bot.user.id})')
    # 启动后台监控任务
    check_result_file.start()

@bot.command()
async def start_check(ctx):
    global target_channel_id
    target_channel_id = ctx.channel.id
    await ctx.send("开始监控result.json文件...")

@tasks.loop(seconds=1)  # 每秒检查一次，可按需调整间隔
async def check_result_file():
    if not target_channel_id:
        return
    channel = bot.get_channel(target_channel_id)
    if not channel:
        return
    
    file_path = "/home/user/Projects/project_folder/result.json"
    try:
        # 用异步文件读取替代同步操作，避免阻塞事件循环
        async with asyncio.open(file_path, 'r') as f:
            result = json.loads(await f.read())
        await channel.send(f"some message, {result['name']}")
        os.remove(file_path)
    except FileNotFoundError:
        pass
    except Exception as e:
        print(f"处理文件出错: {e}")

if __name__ == "__main__":
    bot.run(TOKEN)

2. 关键优化点 #

• 给循环设置合理间隔（比如1秒），避免无意义的资源占用。
• 用异步文件操作替代同步IO，减少事件循环阻塞。
• 将监控逻辑移到后台任务，不占用命令执行的线程资源。

修改后，心跳包能正常发送，警告会消失，机器人可以稳定持续运行。

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