qoder开发node.js接口连接mysql需完成四步闭环：安装pymysql驱动、配置database.py参数、初始化database实例并挂载到app.state、验证连接。缺一不可，否则报importerror或attributeerror等错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder开发Node.js接口时连接MySQL数据库，需完成驱动安装、配置定义、实例初始化与连接验证四步闭环，缺一不可。若跳过PyMySQL安装或MYSQL_CONFIG字段缺失，后续所有数据库操作都会直接报错中断。
安装PyMySQL驱动
Qoder框架底层依赖PyMySQL与MySQL通信，未安装该包会导致Database类无法实例化，调用db.query()时抛出ImportError异常。【必须在项目根目录执行安装】
在终端运行命令：pip install PyMySQL
验证是否成功：执行python -c "import pymysql; print('✅')"，输出✅即表示驱动就绪；若提示ModuleNotFoundError，请检查当前Python环境是否与项目使用的解释器一致。
配置MySQL连接参数
所有连接信息必须统一写入config/database.py文件，且MYSQL_CONFIG字典中host、port、user、password、database五个字段一个都不能少。
编辑config/database.py，添加如下内容：
MYSQL_CONFIG = {<br> "host": "127.0.0.1",<br> "port": 3306,<br> "user": "root",<br> "password": "your_mysql_password",<br> "database": "qoder_app",<br> "charset": "utf8mb4"<br>}
注意：若MySQL服务未运行，或用户名密码错误，此处配置再完整也无法通过后续验证。建议先用mysql -u root -p手动登录确认凭据有效。
初始化Database实例并挂载到app.state
仅配置参数不等于启用数据库功能，必须在应用启动阶段创建Database对象，并绑定至FastAPI/Qoder应用上下文，否则请求中访问app.state.mysql会触发AttributeError。
第一步：在app.py顶部导入模块from qoder.db import Database
第二步：基于配置创建实例mysql_db = Database("mysql", **MYSQL_CONFIG)
第三步：将实例挂载到应用状态app.state.mysql = mysql_db
这一步必须放在app = FastAPI()之后、路由注册之前，否则挂载失败。
验证MySQL连接是否生效
方法一：启动服务后，在任意路由处理函数内执行SQL检测语句
result = await app.state.mysql.query("SELECT VERSION()")
若返回类似[{'VERSION()': '8.0.33'}]的结果，说明连接已通。
方法二：在app.py启动逻辑末尾添加同步验证（仅调试用）await app.state.mysql.query("SELECT 1")
【此行不可保留在生产环境】，否则服务启动会因等待数据库响应而阻塞。
