Typebot.io 自托管部署中的 GitHub OAuth 错误解决方案

问题背景

在 Typebot.io 自托管部署过程中，许多开发者会遇到 GitHub OAuth 认证失败的问题，表现为"Try signing with a different account"错误提示。这个问题通常出现在手动部署流程中，特别是当数据库迁移步骤被忽略时。

核心问题分析

从错误日志中可以发现两个关键问题：

1. 数据库表缺失：Prisma 客户端无法找到 public.Account 和 public.PublicTypebot 表
2. 认证流程中断：由于数据库结构不完整，OAuth 认证流程无法正常完成

根本原因

这个问题的根本原因是数据库迁移步骤被遗漏。Typebot.io 使用 Prisma 作为 ORM 工具，需要执行数据库迁移来创建所有必要的表结构。

完整解决方案

1. 数据库迁移

执行以下命令完成数据库迁移：

pnpm db:migrate

这个命令会应用所有预定义的数据库迁移脚本，创建完整的数据库结构。迁移完成后，系统会自动创建所有必要的表，包括 Account 和 PublicTypebot 等。

2. Supabase 特殊配置（如使用 Supabase）

如果使用 Supabase 作为数据库服务，需要额外配置 DIRECT_URL：

1. 修改 schema.prisma 文件：

datasource db {
  provider  = "postgresql"
  url       = env("DATABASE_URL")
  directUrl = env("DIRECT_URL")
}

2. 在环境变量中添加：

DIRECT_URL=postgres://[db-user].[project-ref]:[db-password]@aws-0-[aws-region].pooler.supabase.com:5432/[db-name]

注意必须使用 5432 端口，这是 Supabase 的标准配置。

3. 环境变量验证

确保以下关键环境变量已正确配置：

NEXTAUTH_URL=https://your-domain.com
NEXT_PUBLIC_VIEWER_URL=https://bot.your-domain.com
GITHUB_CLIENT_ID=your_client_id
GITHUB_CLIENT_SECRET=your_client_secret

4. 服务重启

完成上述步骤后，重启 Typebot 服务使更改生效：

pm2 restart typebot

预防措施

1. 部署清单：创建部署检查清单，确保不遗漏任何步骤
2. 日志监控：定期检查 PM2 日志，及时发现类似问题
3. 文档参考：仔细阅读官方文档的部署要求部分

总结

Typebot.io 自托管部署中的 GitHub OAuth 认证问题通常源于数据库迁移步骤的缺失。通过执行完整的数据库迁移流程，并确保 Supabase 的特殊配置（如适用），可以解决大多数认证相关问题。部署过程中应特别注意环境变量的正确性和服务的完整重启，以确保所有更改生效。

对于初次部署 Typebot.io 的开发者，建议在测试环境中先完整走通整个部署流程，再在生产环境中实施，可以有效避免类似问题的发生。