Qoder集成MySQL需四步：一、安装PyMySQL并验证；二、在config/database.py中配置完整连接参数；三、在app.py中初始化Database实例并挂载至app.state.mysql；四、可通过环境变量动态注入配置；五、用SELECT VERSION()验证连接。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在尝试将Qoder框架与MySQL数据库进行集成，但遇到连接失败、驱动未识别或初始化报错等问题，则可能是由于PyMySQL驱动缺失、配置参数错误或初始化时机不当所致。以下是完成该集成任务的具体步骤：
一、安装PyMySQL数据库驱动
Qoder框架依赖PyMySQL作为MySQL通信底层驱动，未安装该包将导致Database类无法实例化，调用db.query()时直接抛出ImportError异常。必须确保驱动版本与Python解释器兼容且已全局可用。
1、在终端中执行以下命令安装PyMySQL：
2、验证安装是否成功，运行检测语句：
python -c "import pymysql; print('✅ PyMySQL imported successfully')"
3、若输出✅提示则表示驱动就绪；若提示ModuleNotFoundError，则需检查pip源或Python环境路径。
二、配置MySQL连接参数
Qoder通过config/database.py统一管理数据源配置，必须显式定义MYSQL_CONFIG字典，其中host、port、user、password、database字段缺一不可。任意字段值与MySQL服务实际部署信息不一致，均会导致连接超时或认证拒绝。
1、在config/database.py文件中添加如下配置块：
MYSQL_CONFIG = { "host": "127.0.0.1", "port": 3306, "user": "root", "password": "your_mysql_password", "database": "qoder_app", "charset": "utf8mb4" }
2、确认MySQL服务已在本地运行，并可通过mysql -u root -p命令手动登录验证。
3、如使用远程MySQL服务器，须将host替换为对应IP地址，并确保防火墙放行3306端口及用户授权允许远程连接。
三、初始化MySQL数据库实例
仅配置参数不足以启用数据库功能，必须在应用启动阶段创建Database对象并挂载至Qoder应用上下文。若初始化代码位置错误（例如置于路由定义之后），会导致后续请求中访问app.state.mysql时触发AttributeError。
1、在app.py顶部导入必要模块：
from qoder.db import Database
2、基于配置创建MySQL连接实例：
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
mysql_db = Database("mysql", **MYSQL_CONFIG)
3、将实例绑定至FastAPI或Qoder应用状态：
app.state.mysql = mysql_db
四、通过环境变量方式注入MySQL配置
为提升部署灵活性与安全性，Qoder支持从系统环境变量读取MySQL连接参数。该方式可避免敏感信息硬编码于配置文件中，适用于Docker容器或CI/CD流水线场景。
1、在PowerShell或CMD中设置以下变量：
$env:MYSQL_HOST="127.0.0.1"; $env:MYSQL_PORT="3306"; $env:MYSQL_USER="root"; $env:MYSQL_PASSWORD="root"; $env:MYSQL_DATABASE="ai_code_ratio"
2、修改config/database.py，改用os.getenv动态获取：
import os; MYSQL_CONFIG = { "host": os.getenv("MYSQL_HOST"), "port": int(os.getenv("MYSQL_PORT")), "user": os.getenv("MYSQL_USER"), "password": os.getenv("MYSQL_PASSWORD"), "database": os.getenv("MYSQL_DATABASE") }
3、确保所有环境变量均已设置，缺失任一变量将导致NoneType传入Database构造函数而引发TypeError。
五、验证MySQL连接是否生效
初始化完成后，需通过一次实际查询操作确认连接链路完整。Qoder的Database对象提供query()方法执行原生SQL，返回结果集可用于判断连接状态。
1、在任意路由处理函数中插入测试逻辑：
result = app.state.mysql.query("SELECT VERSION() AS version")
2、检查返回值是否为非空列表，例如输出[{"version": "8.0.33"}]即表示连接与查询均成功。
3、若抛出pymysql.err.OperationalError异常，需回溯检查MySQL服务状态、用户权限及网络连通性。
