122 lines
3.0 KiB
Markdown
122 lines
3.0 KiB
Markdown
# 注册邮件发送失败问题修复指南
|
||
|
||
## 🔍 问题描述
|
||
|
||
注册时出现错误：`Error sending confirmation email` (500 Internal Server Error)
|
||
|
||
**原因**：
|
||
- Supabase 配置了 `ENABLE_EMAIL_AUTOCONFIRM=false`，需要发送确认邮件
|
||
- SMTP 配置使用的是假服务（`supabase-mail`, `fake_mail_user`），无法发送邮件
|
||
- 当 Supabase 尝试发送邮件时失败，返回 500 错误
|
||
|
||
## ✅ 解决方案
|
||
|
||
### 方案一：启用自动确认（推荐，开发环境）
|
||
|
||
修改 `supabase_pro/.env` 文件：
|
||
|
||
```env
|
||
## Email auth
|
||
ENABLE_EMAIL_SIGNUP=true
|
||
ENABLE_EMAIL_AUTOCONFIRM=true # 改为 true，跳过邮件验证
|
||
```
|
||
|
||
**优点**：
|
||
- 注册后立即可以登录，无需邮件验证
|
||
- 适合开发和测试环境
|
||
|
||
**缺点**：
|
||
- 生产环境建议使用真实的邮件服务
|
||
|
||
---
|
||
|
||
### 方案二：配置真实的 SMTP 服务
|
||
|
||
修改 `supabase_pro/.env` 文件，配置真实的 SMTP 服务：
|
||
|
||
```env
|
||
## Email auth
|
||
ENABLE_EMAIL_SIGNUP=true
|
||
ENABLE_EMAIL_AUTOCONFIRM=false
|
||
SMTP_ADMIN_EMAIL=your-admin@example.com
|
||
SMTP_HOST=smtp.example.com # 真实的 SMTP 服务器
|
||
SMTP_PORT=587 # 或 465 (SSL)
|
||
SMTP_USER=your-smtp-user
|
||
SMTP_PASS=your-smtp-password
|
||
SMTP_SENDER_NAME=Your App Name
|
||
```
|
||
|
||
**常用 SMTP 服务**：
|
||
- Gmail: `smtp.gmail.com:587`
|
||
- 163: `smtp.163.com:465`
|
||
- QQ: `smtp.qq.com:587`
|
||
- SendGrid, Mailgun 等第三方服务
|
||
|
||
---
|
||
|
||
### 方案三：使用 Supabase 本地邮件服务（开发环境）
|
||
|
||
如果使用 Docker Compose 运行 Supabase，可以使用内置的邮件服务：
|
||
|
||
1. 确保 `supabase-mail` 服务正常运行
|
||
2. 检查邮件服务日志：
|
||
```bash
|
||
docker-compose logs supabase-mail
|
||
```
|
||
3. 如果服务未运行，启动它：
|
||
```bash
|
||
docker-compose up -d supabase-mail
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 已实施的代码修复
|
||
|
||
已改进注册页面的错误处理：
|
||
|
||
1. **检查邮件发送失败错误**：如果返回 500 错误且错误信息包含 "confirmation email"，会给出友好提示
|
||
2. **即使邮件发送失败，用户可能已创建**：提示用户稍后尝试登录
|
||
3. **改进错误提示**：更清晰的错误信息
|
||
|
||
---
|
||
|
||
## 📝 验证步骤
|
||
|
||
1. **修改配置后，重启 Supabase**：
|
||
```bash
|
||
cd supabase_pro
|
||
docker-compose restart auth
|
||
```
|
||
|
||
2. **测试注册**：
|
||
- 尝试注册新用户
|
||
- 如果使用 `ENABLE_EMAIL_AUTOCONFIRM=true`，应该立即可以登录
|
||
- 如果使用真实 SMTP，检查邮箱是否收到确认邮件
|
||
|
||
3. **检查数据库**：
|
||
```sql
|
||
-- 检查 auth.users 表中是否有新用户
|
||
SELECT id, email, email_confirmed_at, created_at
|
||
FROM auth.users
|
||
ORDER BY created_at DESC
|
||
LIMIT 5;
|
||
|
||
-- 检查 ak_users 表中是否有对应记录
|
||
SELECT id, email, username, created_at
|
||
FROM ak_users
|
||
ORDER BY created_at DESC
|
||
LIMIT 5;
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 推荐配置（开发环境）
|
||
|
||
```env
|
||
## Email auth
|
||
ENABLE_EMAIL_SIGNUP=true
|
||
ENABLE_EMAIL_AUTOCONFIRM=true # 开发环境跳过邮件验证
|
||
```
|
||
|
||
这样注册后可以立即登录，无需等待邮件确认。
|