使用asyncio配置SurrealDB，Windows正常Linux报NameError

核心原因 #

1. 事件循环不匹配：Windows与Linux默认的asyncio事件循环实现不同，你手动调用asyncio.get_event_loop().run_until_complete(asetup)初始化的connection，可能存在于独立的事件循环中，而Pycord机器人运行时使用的是自身创建的事件循环，导致后续异步函数无法找到该连接。
2. 全局变量作用域异常：即便声明了global connection，Linux下Python解释器的异步上下文切换逻辑，可能导致赋值后的变量无法同步到所有调用上下文，这是Windows与Linux协程调度差异引发的问题。

修复方案 #

方案1：改用Pycord官方异步初始化方式（推荐） #

Pycord v2.0+支持异步的setup_hook方法，这是替代同步setup函数做异步初始化的官方方案，彻底规避手动管理事件循环的问题：

import discord
from discord.ext import commands
import surrealdb

class MyBot(commands.Bot):
    async def setup_hook(self):
        # 将数据库连接绑定到Bot实例，避免全局变量问题
        self.db_connection = await surrealdb.connect(
            "ws://localhost:8000/rpc",
            user="root",
            pass="root",
            namespace="test",
            database="test"
        )
        # 可在此加载cogs或执行其他异步初始化逻辑

# 实例化机器人
bot = MyBot(command_prefix="!", intents=discord.Intents.all())

# 封装数据库操作函数时，通过Bot实例调用连接
async def run_query(query):
    return await bot.db_connection.query(query)

@bot.command()
async def test_db(ctx):
    result = await run_query("SELECT * FROM user;")
    await ctx.send(str(result))

bot.run("YOUR_BOT_TOKEN")

方案2：用全局容器存储连接 #

如果暂时不想修改Bot类结构，将connection放入全局字典或类实例中，避免裸全局变量的作用域冲突：

import discord
from discord.ext import commands
import surrealdb

# 用全局容器存储连接，替代裸全局变量
db_container = {"connection": None}

async def asetup():
    db_container["connection"] = await surrealdb.connect(
        "ws://localhost:8000/rpc",
        user="root",
        pass="root",
        namespace="test",
        database="test"
    )

def setup(bot):
    # 使用Pycord自带的事件循环执行初始化，而非默认全局循环
    bot.loop.run_until_complete(asetup())

async def run_query(query):
    if not db_container["connection"]:
        raise Exception("数据库连接未初始化")
    return await db_container["connection"].query(query)

方案3：用异步任务替代阻塞式执行 #

若必须在同步setup中触发异步初始化，使用Pycord的事件循环创建异步任务，而非阻塞式运行：

def setup(bot):
    # 用Bot的事件循环创建异步任务，避免独立循环的问题
    bot.loop.create_task(asetup())

注意：这种方式需要确保数据库操作前连接已初始化完成，可在on_ready事件中添加等待逻辑，比如用asyncio.Event标记连接就绪状态。

关键注意事项 #

• 永远优先使用bot.loop而非手动获取默认事件循环，Pycord会自行管理事件循环的生命周期。
• 异步多上下文环境中，裸全局变量极易出现作用域问题，优先将状态绑定到Bot实例或专门的全局容器中。

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