在create-t3-turbo项目中使用MySQL2替代PlanetScale的实践指南

create-t3-turbo是一个基于T3 Stack的现代化全栈开发模板项目。在实际开发中，开发者可能需要将默认的PlanetScale数据库替换为本地MySQL或其他MySQL兼容数据库。本文将详细介绍如何在该项目中正确配置MySQL2驱动来替代PlanetScale。

为什么需要替换数据库驱动

PlanetScale虽然提供了便捷的云数据库服务，但在某些场景下，开发者可能需要：

• 使用本地开发环境中的MySQL实例
• 连接到自托管的MySQL服务器
• 避免云服务依赖
• 进行特定的功能测试

配置步骤

1. 安装MySQL2依赖

首先需要安装MySQL2驱动包，这是Node.js中连接MySQL数据库的常用选择。

2. 修改数据库连接配置

在数据库连接文件中，需要进行以下调整：

import { drizzle } from 'drizzle-orm/mysql2';
import { createConnection } from 'mysql2/promise';

// 合并所有schema定义
export const schema = { ...auth, ...post };

// 导出表创建器
export { mySqlTable as tableCreator } from "./schema/_table";

// 导出drizzle-orm的所有内容
export * from "drizzle-orm";

// 创建MySQL连接
const mySql = await createConnection({
  host: process.env.DB_HOST!,
  user: process.env.DB_USERNAME!,
  password: process.env.DB_PASSWORD!,
  database: process.env.DB_NAME!,
});

// 创建drizzle实例
export const db = drizzle(mySql, { schema, mode: "default" });

3. 环境变量配置

确保在.env文件中配置了正确的MySQL连接信息：

DB_HOST=localhost
DB_USERNAME=your_username
DB_PASSWORD=your_password
DB_NAME=your_database

注意事项

1. 运行时环境：MySQL2驱动不支持Edge Runtime环境，如果项目中使用到了Edge Runtime，需要特别注意。

2. 连接池管理：在生产环境中，建议使用连接池而不是直接创建连接，以提高性能和资源利用率。

3. 类型安全：虽然示例中使用了非空断言操作符(!)，但在实际项目中应该添加适当的空值检查。

4. 模式设置：mode: "default"配置确保使用标准的MySQL协议，而不是PlanetScale特有的模式。

替代方案比较

• PlanetScale驱动：专为PlanetScale服务优化，支持无服务器环境，但锁定特定云服务商
• MySQL2驱动：通用性强，支持标准MySQL协议，适合本地开发和自托管场景

通过以上配置，开发者可以灵活地在create-t3-turbo项目中使用本地MySQL或其他兼容MySQL的数据库服务，而不必依赖PlanetScale云服务。这种替换为项目提供了更大的部署灵活性，特别适合需要完全控制数据库环境的开发场景。