一次性邮箱检测与注册拦截实战

Sun, 23 Jun 2024 00:00:00 +0000

注册时拦截掉一次性邮箱，既能减少垃圾用户，也能让邮件投递数据更干净。

为什么要拦截一次性邮箱

SaaS 项目上线后，你会发现注册用户里有一批用临时邮箱的——10分钟邮箱、一次性邮箱。这些用户：

不会验证邮箱（因为邮箱已经过期了）
浪费邮件发送配额
污染用户数据，影响分析

所以在注册时就拦截掉。

双服务冗余检测

RuiToolAI 用了两个免费的一次性邮箱检测服务，串行调用，任一返回"是临时邮箱"就拦截：

debounce.io — 免费的 disposable email 检测 API
mailcheck.ai — 同样是免费的，作为备选

为什么要两个？因为单个免费服务可能宕机，双服务冗余能保证可用性。逻辑是：

先调 debounce.io，如果返回"是临时邮箱" → 直接拦截
如果 debounce.io 失败或返回"不是" → 再调 mailcheck.ai
两个都失败 → 放行（不阻塞正常用户注册）

实现代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96


// src/utils/auth.ts

interface DisposableEmailResponse {
 disposable: string;
}

interface MailcheckResponse {
 email: string;
 domain: string;
 mx: boolean;
 disposable: boolean;
 public_domain: boolean;
 relay_domain: boolean;
 alias: boolean;
}

interface ValidatorResult {
 success: boolean;
 isDisposable: boolean;
}

async function checkWithDebounce(email: string): Promise<ValidatorResult> {
 try {
 const response = await fetch(
 `https://disposable.debounce.io/?email=${encodeURIComponent(email)}`
 );

 if (!response.ok) {
 console.error("Debounce.io API error:", response.status);
 return { success: false, isDisposable: false };
 }

 const data = await response.json() as DisposableEmailResponse;
 return { success: true, isDisposable: data.disposable === "true" };
 } catch (error) {
 console.error("Failed to check disposable email with debounce.io:", error);
 return { success: false, isDisposable: false };
 }
}

async function checkWithMailcheck(email: string): Promise<ValidatorResult> {
 try {
 const response = await fetch(
 `https://mailcheck.ai/api/check?email=${encodeURIComponent(email)}`
 );

 if (!response.ok) {
 console.error("Mailcheck.ai API error:", response.status);
 return { success: false, isDisposable: false };
 }

 const data = await response.json() as MailcheckResponse;
 return { success: true, isDisposable: data.disposable };
 } catch (error) {
 console.error("Failed to check disposable email with mailcheck.ai:", error);
 return { success: false, isDisposable: false };
 }
}

export async function canSignUp({
 email,
 skipDisposableEmailCheck = false,
}: {
 email: string;
 skipDisposableEmailCheck?: boolean;
}): Promise<void> {
 if (!isProd) {
 return;
 }

 if (skipDisposableEmailCheck) {
 return;
 }

 const checkers = [checkWithDebounce, checkWithMailcheck];

 for (const checker of checkers) {
 const result = await checker(email);

 if (!result.success) {
 continue;
 }

 if (result.isDisposable) {
 throw new ActionError(
 "PRECONDITION_FAILED",
 "Disposable email addresses are not allowed. Please use a permanent email address."
 );
 }

 return;
 }

 // 两个服务都失败了，放行
 console.warn("Both disposable email check services failed, allowing signup");
}

注册流程中的集成

在注册 Action 中，canSignUp 是第一个校验步骤：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29


// src/app/(auth)/sign-up/sign-up.actions.ts

export const signUpAction = actionClient
 .inputSchema(signUpSchema)
 .action(async ({ parsedInput: input }) => {
 return withRateLimit(async () => {
 const db = getDB();

 // 1. 验证 Turnstile（如果启用）
 if (await isTurnstileEnabled()) {
 // ...
 }

 // 2. 检查是否一次性邮箱
 await canSignUp({ email: input.email });

 // 3. 检查邮箱是否已被注册
 const existingUser = await db.query.userTable.findFirst({
 where: eq(userTable.email, input.email),
 });

 if (existingUser) {
 throw new ActionError("CONFLICT", "Email already taken");
 }

 // 4. 创建用户
 // ...
 }, RATE_LIMITS.SIGN_UP);
 });

开发环境跳过检测

开发环境不需要调外部 API，直接跳过：

1
2
3


if (!isProd) {
 return;
}

isProd 判断的是 process.env.NODE_ENV === "production"（在 Vinext 构建中这个值是正确的）。

总结

两个免费 API 冗余调用，任一命中就拦截
两个都失败时放行，不阻塞正常用户
放在注册校验的最前面，尽早拦截
开发环境自动跳过