1. MySQL 在 Egg.js 中的深度集成与实践
作为现代 Web 开发的核心组件,数据库操作是每个开发者必须掌握的技能。在 Egg.js 框架中,官方提供的 egg-mysql 插件为我们提供了优雅的 MySQL 数据库访问方案。不同于简单的数据库连接,我们需要从工程化角度考虑配置管理、操作封装和性能优化等问题。
1.1 环境准备与插件配置
在开始之前,确保你的开发环境已经安装并运行了 MySQL 服务(推荐 5.7+ 版本)。我建议使用 Docker 来快速搭建开发环境:
bash复制docker run --name mysql-dev -e MYSQL_ROOT_PASSWORD=123456 -p 3306:3306 -d mysql:5.7
安装 egg-mysql 插件时,我强烈建议锁定版本号以避免潜在的兼容性问题:
bash复制npm i --save egg-mysql@3.0.0
在插件配置环节,很多新手会忽略 app 和 agent 这两个关键参数的区别:
app: true表示将 mysql 实例挂载到 app 对象上agent: false表示不在多进程模式下使用 agent 进程管理连接
提示:在生产环境中,建议将数据库配置放在独立的配置文件中,并通过环境变量注入敏感信息,切勿将密码直接硬编码在代码中。
1.2 多环境配置策略
实际项目中,我们需要为不同环境(开发、测试、生产)配置不同的数据库连接。Egg.js 的配置文件体系完美支持这种需求:
javascript复制// config/config.default.js
exports.mysql = {
client: {
host: '127.0.0.1',
port: '3306',
user: 'root',
password: process.env.MYSQL_PASSWORD || 'dev_password',
database: 'test_dev'
}
};
// config/config.prod.js
exports.mysql = {
client: {
host: process.env.MYSQL_HOST || 'mysql.prod.com',
port: process.env.MYSQL_PORT || '3306',
user: process.env.MYSQL_USER || 'prod_user',
password: process.env.MYSQL_PASSWORD,
database: process.env.MYSQL_DATABASE || 'app_prod'
}
};
对于多数据源场景,我推荐使用命名空间来区分不同业务模块的数据库访问:
javascript复制exports.mysql = {
clients: {
userDB: {
host: 'user.db.service',
// ...其他配置
},
orderDB: {
host: 'order.db.service',
// ...其他配置
}
},
default: {
// 默认配置
}
};
1.3 高级连接池配置
egg-mysql 底层使用 mysql2 驱动,我们可以通过 pool 参数优化连接池性能:
javascript复制exports.mysql = {
client: {
// ...基础配置
pool: {
max: 20, // 最大连接数
min: 3, // 最小连接数
acquireTimeout: 30000, // 获取连接超时时间(ms)
idleTimeout: 10000 // 连接空闲超时时间(ms)
},
connectionLimit: 10, // 单连接限制
queueLimit: 1000 // 排队请求限制
}
};
经验分享:根据我的实践,对于常规应用,max 设置为 CPU 核心数的 5-10 倍是比较合理的。过大的连接数反而会导致性能下降。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 数据库操作最佳实践
2.1 Service 层封装模式
在 Egg.js 中,我们应该严格遵循分层架构原则,将数据库操作封装在 Service 层。这里展示一个完整的用户服务示例:
javascript复制// app/service/user.js
const { Service } = require('egg');
class UserService extends Service {
// 创建用户
async create(userData) {
const { ctx } = this;
try {
const result = await ctx.app.mysql.insert('users', {
...userData,
created_at: ctx.app.mysql.literals.now,
updated_at: ctx.app.mysql.literals.now
});
if (result.affectedRows !== 1) {
ctx.throw(500, '用户创建失败');
}
return result.insertId;
} catch (e) {
if (e.code === 'ER_DUP_ENTRY') {
ctx.throw(409, '用户名已存在');
}
ctx.throw(500, '数据库操作异常');
}
}
// 分页查询
async list({ page = 1, pageSize = 10, where = {} }) {
const { ctx } = this;
const offset = (page - 1) * pageSize;
const [users, total] = await Promise.all([
ctx.app.mysql.select('users', {
where,
limit: pageSize,
offset,
orders: [['i
