Remix.js indie-stack从SQLite切换至MySQL的适配要点排查

• 环境变量配置修正
  替换原SQLite格式的DATABASE_URL为MySQL连接字符串，针对Google Cloud SQL需注意：

  • 若使用Unix套接字，格式为 mysql://<用户名>:<密码>@localhost/<数据库名>?socket=/cloudsql/<项目ID>:<区域>:<实例ID>
  • 若使用公网连接，需添加SSL参数（如sslmode=require），或启用Cloud SQL Auth Proxy确保安全连接
  • 确认.env文件中所有数据库相关变量（如DATABASE_URL）已更新并生效

• 重新生成Prisma客户端
  修改schema.prisma后必须执行 npx prisma generate，确保客户端代码适配MySQL驱动，避免旧SQLite相关逻辑残留

• 数据库访问权限验证

  • 检查Google Cloud SQL实例的防火墙规则，允许应用部署环境（如Cloud Run、VPC）的IP访问
  • 确认数据库用户拥有足够权限（CREATE、SELECT、INSERT、UPDATE、DELETE等），避免因权限不足导致操作失败
  • 若使用IAM数据库认证，需配置对应的服务账号权限并更新连接字符串

• 数据类型与Schema细节适配

  • 修正SQLite与MySQL的数据类型差异：比如SQLite的INTEGER自增在MySQL中需用AUTO_INCREMENT（Prisma会自动处理，但需确认schema中@id @default(autoincrement())配置正确）
  • 日期类型：SQLite用TEXT存储日期，MySQL用DATETIME/TIMESTAMP，需确保Prisma schema中的DateTime类型映射正确，同时注意时区配置（可在连接字符串中添加timezone=UTC）
  • 避免SQLite特有的语法，比如AUTOINCREMENT关键字（MySQL中仅需AUTO_INCREMENT）

• 迁移执行与验证
  执行 npx prisma migrate deploy 将迁移脚本应用到Google Cloud SQL实例，之后通过npx prisma studio或数据库客户端检查表结构是否正确创建，确认无迁移失败日志

• 连接池与性能配置
  在schema.prisma的datasource db块中调整MySQL适配的连接池参数，比如：

  datasource db {
    provider = "mysql"
    url      = env("DATABASE_URL")
    pool_size = 5 // 根据应用流量调整，避免超过Cloud SQL连接限制
  }
  

  同时检查连接超时设置，避免因Cloud SQL网络延迟导致连接失败

• 应用代码兼容性检查

  • 排查代码中是否存在SQLite特定的查询逻辑（比如date()函数在MySQL中需调整为DATE()）
  • 事务逻辑：SQLite与MySQL的事务隔离级别默认不同，需确认应用中的事务行为符合预期，避免死锁或数据一致性问题

• 测试数据迁移（若有）
  若原SQLite数据库有测试数据，导入MySQL时需注意：

  • 日期格式转换（SQLite的TEXT日期需转为MySQL可识别的DATETIME格式）
  • 特殊字符转义，避免导入时出现语法错误

内容的提问来源于stack exchange，提问作者02_Helium