Spring Boot项目连接MySQL数据库需五步：一、用Spring Initializr勾选Spring Web、Spring Data JPA和MySQL Driver依赖；二、在pom.xml中添加mysql-connector-j运行时依赖；三、在application.yml中配置含serverTimezone的JDBC URL、用户名密码及驱动类；四、创建带@Entity和@Table注解的实体类；五、启动后通过控制台日志和/actuator/health验证连接是否就绪。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder开发Spring Boot项目如何连接MySQL数据库？这个问题存在概念混淆——Qoder是一个独立的Python异步Web框架，与Spring Boot（Java生态）完全不兼容，无法在同一个项目中混用。若你实际想用Spring Boot连接MySQL，请按以下步骤操作；若你本意是用Qoder连接MySQL，则无需Spring Boot参与。
Spring Boot项目连接MySQL数据库
第一步：确认项目已初始化并具备基础依赖
使用Spring Initializr创建项目时，必须勾选 Spring Web、Spring Data JPA 和 MySQL Driver 三项依赖。缺一不可，否则后续配置将无法被自动识别或触发数据源初始化。
第二步：添加MySQL驱动依赖（以Maven为例）
打开 pom.xml，确保包含以下依赖块：
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<scope>runtime</scope>
</dependency>
注意：Spring Boot 3.x 起强制要求使用 mysql-connector-j（非旧版 mysql-connector-java），否则启动时报 ClassNotFoundException。
第三步：配置数据库连接参数
在 src/main/resources/application.yml 中写入如下内容：
spring:
datasource:
url: jdbc:mysql://localhost:3306/your_db_name?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
username: root
password: your_password
driver-class-name: com.mysql.cj.jdbc.Driver
jpa:
hibernate:
ddl-auto: update
show-sql: true
【serverTimezone=UTC 是必需项】，MySQL 8.0+ 默认启用严格时区校验，不加此参数会导致连接卡死或抛出 The server time zone value 'xxx' is unrecognized 异常。
第四步：创建实体类并启用JPA映射
新建 com.example.demo.entity.User.java，添加 @Entity 和 @Table(name = "users") 注解，并确保主键字段标注 @Id @GeneratedValue(strategy = GenerationType.IDENTITY)。JPA只有识别到合法实体类，才会尝试建立表结构映射。
第五步：验证连接是否生效
启动应用后观察控制台日志，若出现类似 HikariPool-1 - Starting... 和 schema generated 字样，说明数据源已成功初始化；再访问 http://localhost:8080/actuator/health，返回中 "db":"UP" 即表示MySQL连接就绪。
Qoder框架连接MySQL数据库
方法一：安装PyMySQL驱动并验证
在项目根目录终端执行：pip install PyMySQL；随后运行 python -c "import pymysql; print(pymysql.VERSION)"。输出版本号（如 (1, 1, 0)）即表示驱动可用。
方法二：配置database.py连接参数
在 config/database.py 中定义 MYSQL_CONFIG 字典，必须包含 host、port、user、password、database 五项，缺任意一项都会导致 ConnectionRefusedError 或认证失败。
方法三：在app.py中完成初始化
导入 Database 类后，调用 mysql_db = Database("mysql", **MYSQL_CONFIG) 创建实例，再通过 app.state.mysql = mysql_db 挂载到FastAPI/Qoder应用上下文。这一步必须放在 app = FastAPI() 之后、路由注册之前，否则 app.state.mysql 在中间件或路由中访问时为 None。
最后执行 SELECT VERSION() 查询验证：
在任意路由处理函数中写入 await app.state.mysql.query("SELECT VERSION()")，返回结果含 MySQL 版本字符串（如 ('8.0.33',)）即表示连接成功。
