简介：本文详解如何免费使用PlanetScale云数据库搭配Vercel部署应用，涵盖从注册到数据库操作的全流程，助开发者零成本搭建MySQL环境。

一、为什么选择PlanetScale+Vercel组合？

1.1 开发者生态的完美契合

Vercel作为全球领先的Serverless部署平台，凭借其”零配置”的CI/CD流程和全球CDN加速，已成为Next.js等现代框架的首选部署方案。而PlanetScale作为基于Vitess的Serverless MySQL数据库，其架构设计天然适配Serverless应用场景。两者结合可实现：

自动扩缩容：数据库连接数随Vercel实例动态调整
全球低延迟：PlanetScale的全球分片架构与Vercel的边缘网络形成互补
开发闭环：从代码提交到数据库变更的全流程自动化

1.2 成本效益分析

对比传统方案：
| 方案 | 数据库成本 | 部署成本 | 运维复杂度 |
|———|——————|—————|——————|
| 传统VPS | $5/月起 | $5/月起 | 中等 |
| AWS RDS | $0.015/小时 | 免费层有限 | 高 |
| PlanetScale+Vercel | 免费层充足 | 免费层充足 | 极低 |

PlanetScale的免费层提供：

1个数据库分支
10GB存储空间
每月1000万次读取/100万次写入
连接数上限100（Vercel实例通常仅需5-10个连接）

二、PlanetScale实战操作指南

2.1 注册与初始化

访问PlanetScale官网使用GitHub账号授权登录
创建新组织（Organization）并完成邮箱验证
在Dashboard点击”New database”创建数据库
- 推荐选择”Develop”计划（免费层）
- 区域选择建议：
  - 亚太用户：东京/新加坡
  - 欧美用户：弗吉尼亚/法兰克福

2.2 数据库分支管理

PlanetScale的分支功能是其核心优势：

# 通过CLI创建开发分支（需先安装planetscale CLI）
pscale branch create mydb dev-branch --database mydb
# 查看分支状态
pscale branch list mydb

分支特性：

独立schema变更：可在分支上修改表结构而不影响主库
快速回滚：通过pscale branch promote可快速将分支提升为主库
协作开发：多个开发者可在不同分支并行工作

2.3 连接配置

获取连接字符串的三种方式：

Vercel集成：
- 在PlanetScale的Database页面选择”Connect”→”Vercel”
- 授权后自动注入环境变量

手动配置：

// Next.js示例（.env.local）
DATABASE_URL="mysql://user:pass@host/dbname?ssl_mode=REQUIRED"

Prisma适配：

// schema.prisma
datasource db {
  provider = "mysql"
  url      = env("DATABASE_URL")
  shadowDatabaseUrl = env("SHADOW_DATABASE_URL") // 用于迁移测试
}

2.4 迁移工具链

PlanetScale原生支持无损schema变更：

# 1. 安装迁移工具
npm install -g @planetscale/cli
# 2. 生成迁移文件
pscale schema generate mydb dev-branch > migration.sql
# 3. 应用迁移
pscale schema apply mydb dev-branch --file migration.sql

三、Vercel集成最佳实践

3.1 环境变量管理

在Vercel项目设置中：

添加DATABASE_URL环境变量（从PlanetScale的Connect页面获取）
对于生产环境，建议：
- 使用Vercel的”Encrypted”环境变量
- 不同环境（dev/preview/prod）使用不同数据库分支

3.2 连接池优化

// 使用mysql2/promise的优化配置
const pool = createPool({
  host: process.env.DB_HOST,
  user: process.env.DB_USER,
  password: process.env.DB_PASSWORD,
  database: process.env.DB_NAME,
  waitForConnections: true,
  connectionLimit: 10, // Vercel实例通常5-10个连接足够
  queueLimit: 0,
  ssl: { rejectUnauthorized: true }
});

3.3 部署钩子设置

在vercel.json中配置：

{
  "build": {
    "env": {
      "NODE_ENV": "production"
    }
  },
  "hooks": {
    "after-deploy": "curl -X POST https://api.planetscale.com/v1/databases/{db}/branches/{branch}/deploy-requests"
  }
}

四、高级功能探索

4.1 读写分离实现

PlanetScale自动处理：

// 连接时指定readReplica参数
const connection = mysql.createConnection({
  host: 'primary.region.planetscale.com',
  readReplicaHost: 'replica.region.planetscale.com',
  // ...其他参数
});

4.2 监控与告警

在PlanetScale Dashboard设置：

查询性能监控（QPS/延迟）
连接数告警（阈值建议设为80）
存储空间预警（剩余20%时触发）

4.3 灾难恢复方案

定期导出：

pscale dump mydb main --output=backup.sql

跨区域复制：通过分支在不同区域创建副本
点时间恢复：可恢复到任意秒级时间点

五、常见问题解决方案

5.1 连接超时问题

现象：ETIMEDOUT错误

解决方案：

// 增加连接超时时间
const connection = mysql.createConnection({
  timeout: 30000, // 30秒
  // ...其他参数
});

5.2 SSL证书验证失败

原因：Node.js环境缺少CA证书

解决方案：

# 在Linux服务器上安装CA证书
sudo apt-get install ca-certificates

5.3 分支合并冲突

预防措施：
1. 合并前执行pscale schema diff mydb branch1 branch2
2. 使用--execute参数自动生成合并脚本
3. 在非高峰期执行重大schema变更

六、性能优化建议

6.1 查询优化

使用PlanetScale的Query Insights识别慢查询

对频繁查询的表添加适当索引：

ALTER TABLE users ADD INDEX idx_email (email);

6.2 连接管理

实现连接复用：

// 使用连接池的getConnection方法
async function queryDb(sql) {
  const connection = await pool.getConnection();
  try {
    const [rows] = await connection.query(sql);
    return rows;
  } finally {
    connection.release();
  }
}

6.3 缓存策略

对静态数据实施Redis缓存
使用PlanetScale的分支特性创建只读副本

七、未来升级路径

当项目规模扩大时：

升级到Hobby计划（$29/月）：
- 增加分支数量
- 提升QPS限制
专业计划（$99/月）：
- 专用读副本
- 99.95% SLA
企业方案：
- 单租户部署
- 自定义SLA

通过这种渐进式升级策略，开发者可以在保持架构一致性的同时，根据业务需求灵活扩展。PlanetScale+Vercel的组合不仅适用于个人项目，对于中小型企业的MVP开发同样具有极高的性价比。

（全文约3200字，涵盖从基础配置到高级优化的完整解决方案）

白嫖党福音：PlanetScale+Vercel免费MySQL全攻略