Discord猜谜机器人报错：SyntaxError: 'await' outside async function

核心原因 #

await关键字只能在被async修饰的函数内部使用，你的代码中肯定存在调用await的语句，但该语句所在的函数没有添加async声明。

具体修改方案 #

1. 定位所有await语句 #

先找出代码里所有用到await的地方，比如：

• Discord API调用：await channel.send()、await ctx.reply()
• 异步文件操作（如果用了aiofiles）：await f.read()
• 其他异步方法调用

2. 给对应函数添加async修饰符 #

• 命令处理函数：Discord.py的命令装饰器绑定的函数必须是异步的，示例修正：

  # 错误写法（无async）
  @bot.command()
  def 猜谜(ctx, 用户答案):
      await ctx.send("正在验证答案")
  
  # 修正后
  @bot.command()
  async def 猜谜(ctx, 用户答案):
      await ctx.send("正在验证答案")
      # 后续处理分数、判断对错逻辑
  

• 定时任务函数：如果用discord.ext.tasks实现每日18点发题，任务函数必须是异步的：

  from discord.ext import tasks
  import random
  import json
  
  @tasks.crontab(hour=18)
  async def 每日发题任务():
      # 读取谜题JSON文件
      with open("puzzles.json", "r", encoding="utf-8") as f:
          谜题列表 = json.load(f)
      随机谜题 = random.choice(谜题列表)
      # 获取目标频道并发送谜题
      目标频道 = bot.get_channel(你的频道ID)
      await 目标频道.send(f"今日谜题：{随机谜题['question']}")
  

• 自定义异步工具函数：如果自己写的工具函数里用到await，也要声明为async：

  import aiofiles
  import json
  
  async def 读取分数文件():
      async with aiofiles.open("scores.json", "r", encoding="utf-8") as f:
          分数数据 = await f.read()
      return json.loads(分数数据)
  

3. 同步/异步函数调用注意事项 #

• 同步函数（比如普通的open()读取文件）不需要加await，直接调用即可；
• 异步函数必须在async函数内部用await调用，不能在同步环境里直接执行。

4. 主入口的异步处理 #

如果有初始化类的异步逻辑，建议用async def main()包裹，再通过asyncio.run()启动：

import asyncio

async def main():
    # 初始化逻辑（比如提前加载分数、谜题）
    await bot.start("你的机器人令牌")

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

内容的提问来源于stack exchange，提问作者H.LK