discord.py非命令场景执行async def报错，如何正确实现异步任务？

错误原因 #

1. 非异步上下文访问事件循环：discord.py v2.x版本后，客户端的loop属性不再在初始化时创建，只能在异步上下文（如异步函数、客户端异步钩子）中访问。直接在同步的全局代码里调用client.loop.create_task()，会触发该错误。
2. 参数误用：discord.Client类不需要command_prefix参数，该参数仅针对实现命令功能的commands.Bot类，属于无效参数。

修复方案 #

方案一：使用setup_hook钩子（推荐） #

setup_hook是discord.py v2.x新增的异步初始化钩子，会在客户端启动前执行，属于合法的异步上下文，可安全创建后台任务。

修改后的完整代码：

from discord.ext import commands
import json
import discord
import asyncio
import pathlib
from pathlib import Path

# 若不需要命令功能，用discord.Client即可，移除无效的command_prefix参数
client = discord.Client(intents=discord.Intents.all())
# 若需要命令功能，替换为以下代码：
# client = commands.Bot(command_prefix="!", intents=discord.Intents.all())

dir_path = pathlib.Path.cwd()
path_class_components = Path(dir_path, 'class_app', 'class_components')
path_class_components = str(path_class_components).replace("\class_wark\class_app","").replace("\\\\", "\\")+"\\config.json"

config = json.load(open(path_class_components, 'r'))

async def my_background_task():
    await client.wait_until_ready()
    counter = 0
    channel = client.get_channel(id=970589128355905539)  # 替换为你的目标频道ID
    # 增加频道存在性判断，避免后续报错
    if not channel:
        print("指定频道不存在，请检查频道ID是否正确")
        return
    while not client.is_closed():
        counter += 1
        await channel.send(f"{counter}")
        await asyncio.sleep(60)

@client.event
async def on_ready():
    print('Logged in as')
    print(client.user.name)
    print(client.user.id)
    print('------')

# 用setup_hook注册后台任务
@client.event
async def setup_hook():
    client.loop.create_task(my_background_task())

client.run(config['token'])

方案二：使用异步主函数 #

将整个客户端初始化、任务注册逻辑放到异步主函数中，通过asyncio.run()启动，确保所有操作都在异步上下文里执行。

修改后的完整代码：

from discord.ext import commands
import json
import discord
import asyncio
import pathlib
from pathlib import Path

async def main():
    # 若不需要命令功能，用discord.Client即可
    client = discord.Client(intents=discord.Intents.all())
    # 若需要命令功能，替换为以下代码：
    # client = commands.Bot(command_prefix="!", intents=discord.Intents.all())

    dir_path = pathlib.Path.cwd()
    path_class_components = Path(dir_path, 'class_app', 'class_components')
    path_class_components = str(path_class_components).replace("\class_wark\class_app","").replace("\\\\", "\\")+"\\config.json"

    config = json.load(open(path_class_components, 'r'))

    async def my_background_task():
        await client.wait_until_ready()
        counter = 0
        channel = client.get_channel(id=970589128355905539)  # 替换为你的目标频道ID
        if not channel:
            print("指定频道不存在，请检查频道ID是否正确")
            return
        while not client.is_closed():
            counter += 1
            await channel.send(f"{counter}")
            await asyncio.sleep(60)

    @client.event
    async def on_ready():
        print('Logged in as')
        print(client.user.name)
        print(client.user.id)
        print('------')

    # 在异步上下文内注册后台任务
    client.loop.create_task(my_background_task())
    await client.start(config['token'])

if __name__ == "__main__":
    asyncio.run(main())

额外注意事项 #

• 确保在Discord开发者平台开启机器人所需的消息内容意图（Message Content Intent），否则机器人无法发送消息。
• 频道ID必须是有效的整数，且机器人有权限向该频道发送消息。
• 若需要实现命令功能，必须使用commands.Bot类，discord.Client仅用于基础的事件监听。

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