Android应用邮箱注册与密码找回系统实现指南-开发者社区

1. 项目背景与核心需求

在移动应用开发中，用户账号体系是几乎所有应用的基础功能模块。而邮箱注册+密码找回功能，则是构建完整账号体系的关键环节。不同于第三方登录（如微信、Google登录），邮箱注册能给予开发者更高的用户数据自主权，同时邮箱作为全球通用的身份标识，其覆盖面和稳定性远超手机号（尤其在国际化应用中）。

我在最近开发的Android社交类App中，就完整实现了这套系统。从技术实现角度看，这涉及到以下核心模块：

前端：注册/登录/找回密码的UI交互流程
后端：账号CRUD、邮箱验证、密码加密存储
基础设施：SMTP邮件服务、API安全防护

2. 技术方案选型与架构设计

2.1 整体架构

采用经典的前后端分离架构：

Android客户端 → REST API → 后端服务 → 数据库 ↓ 邮件服务

2.2 关键技术选型

客户端侧：

使用Jetpack Compose构建UI
Retrofit + Kotlin协程处理网络请求
Android KeyStore存储本地敏感信息

服务端侧：

Spring Boot 3.x（Java 17）
Spring Security处理认证授权
JWT作为无状态token
PostgreSQL存储用户数据
Amazon SES作为邮件发送服务

2.3 安全设计要点

密码存储：
- 使用Argon2id算法（而非SHA/MD5）
- 每个用户独立salt
- 服务端强制密码复杂度策略
通信安全：
- 全链路HTTPS
- 关键API增加速率限制
- 敏感操作需要二次验证
防滥用措施：
- 邮箱验证码有效期15分钟
- 同一IP注册频率限制
- 密码错误次数限制

3. 核心功能实现细节

3.1 邮箱注册流程实现

客户端关键代码（Kotlin）：

@Composable fun RegisterScreen(viewModel: AuthViewModel) { var email by remember { mutableStateOf("") } var password by remember { mutableStateOf("") } Column { OutlinedTextField( value = email, onValueChange = { email = it }, label = { Text("邮箱") }, keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Email) ) OutlinedTextField( value = password, onValueChange = { password = it }, label = { Text("密码") }, visualTransformation = PasswordVisualTransformation() ) Button(onClick = { viewModel.register(email, password) }) { Text("注册") } } }

服务端关键逻辑（Java）：

@PostMapping("/register") public ResponseEntity<?> register(@Valid @RequestBody RegisterRequest request) { if (userRepository.existsByEmail(request.getEmail())) { throw new EmailAlreadyExistsException(); } User user = new User(); user.setEmail(request.getEmail()); user.setPassword(passwordEncoder.encode(request.getPassword())); user.setEnabled(false); // 等待邮箱验证 String verificationCode = generateVerificationCode(); user.setVerificationCode(verificationCode); userRepository.save(user); // 发送验证邮件 emailService.sendVerificationEmail(user.getEmail(), verificationCode); return ResponseEntity.ok().build(); }

3.2 密码找回流程实现

关键步骤：

用户输入注册邮箱
系统发送包含重置链接的邮件
用户点击链接进入密码重置页面
提交新密码完成重置

安全注意事项：

重置链接需包含一次性token
token有效期不超过24小时
重置后使所有现有会话失效
记录重置操作日志

服务端实现示例：

@PostMapping("/forgot-password") public ResponseEntity<?> forgotPassword(@RequestParam String email) { User user = userRepository.findByEmail(email) .orElseThrow(UserNotFoundException::new); String resetToken = generateResetToken(); user.setResetToken(resetToken); user.setResetTokenExpiry(LocalDateTime.now().plusHours(24)); userRepository.save(user); emailService.sendPasswordResetEmail(email, resetToken); return ResponseEntity.ok().build(); }

4. 邮件服务集成实践

4.1 邮件模板设计

验证邮件示例（HTML）：

<!DOCTYPE html> <html> <head> <style> .container { max-width: 600px; margin: 0 auto; } .button { background-color: #4CAF50; color: white; padding: 10px 20px; text-decoration: none; } </style> </head> <body> <div class="container"> <h2>请验证您的邮箱</h2> <p>点击下方按钮完成注册：</p> <a href="${verificationUrl}" class="button">验证邮箱</a> <p>或复制以下链接到浏览器：<br>${verificationUrl}</p> </div> </body> </html>

4.2 邮件发送服务配置

Amazon SES配置示例：

@Configuration public class AwsSesConfig { @Value("${aws.accessKeyId}") private String accessKey; @Value("${aws.secretKey}") private String secretKey; @Bean public SesClient sesClient() { return SesClient.builder() .credentialsProvider(StaticCredentialsProvider.create( AwsBasicCredentials.create(accessKey, secretKey))) .region(Region.AP_NORTHEAST_1) .build(); } }

邮件发送服务实现：

@Service @RequiredArgsConstructor public class EmailServiceImpl implements EmailService { private final SesClient sesClient; private final TemplateEngine templateEngine; @Override public void sendVerificationEmail(String to, String code) { String verificationUrl = "https://yourapp.com/verify?code=" + code; Context context = new Context(); context.setVariable("verificationUrl", verificationUrl); String htmlContent = templateEngine.process("email-verification", context); SendEmailRequest request = SendEmailRequest.builder() .destination(Destination.builder().toAddresses(to).build()) .message(Message.builder() .subject(Content.builder().data("请验证您的邮箱").build()) .body(Body.builder() .html(Content.builder().data(htmlContent).build()) .build()) .build()) .source("noreply@yourapp.com") .build(); sesClient.sendEmail(request); } }

5. 安全增强措施

5.1 密码策略实施

Spring Security配置示例：

@Bean public PasswordEncoder passwordEncoder() { return new Argon2PasswordEncoder( 16, // saltLength 32, // hashLength 4, // parallelism 1 << 16, // memoryCost (64MB) 3 // iterations ); }

密码复杂度校验：

public void validatePassword(String password) { if (password.length() < 8) { throw new WeakPasswordException("密码至少8位"); } // 包含大小写字母、数字、特殊字符 if (!password.matches("^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[@$!%*?&])[A-Za-z\\d@$!%*?&]{8,}$")) { throw new WeakPasswordException("需包含大小写字母、数字和特殊字符"); } }

5.2 防暴力破解措施

登录接口限流配置：

@Bean public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception { http .authorizeHttpRequests(auth -> auth .requestMatchers("/api/auth/login").permitAll() .anyRequest().authenticated() ) .addFilterBefore( new RateLimitFilter(redisTemplate, 5, 1, TimeUnit.MINUTES), UsernamePasswordAuthenticationFilter.class ); return http.build(); }

RateLimitFilter关键实现：

public class RateLimitFilter extends OncePerRequestFilter { private final RedisTemplate<String, String> redisTemplate; private final int maxAttempts; private final long timeout; private final TimeUnit timeUnit; @Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws IOException, ServletException { String ip = request.getRemoteAddr(); String key = "login_attempt:" + ip; Long attempts = redisTemplate.opsForValue().increment(key); if (attempts == 1) { redisTemplate.expire(key, timeout, timeUnit); } if (attempts > maxAttempts) { response.sendError(HttpStatus.TOO_MANY_REQUESTS.value(), "请求过于频繁"); return; } filterChain.doFilter(request, response); } }

6. 测试与验证

6.1 测试用例设计

关键测试场景：

正常注册流程
重复邮箱注册
无效邮箱格式
弱密码检测
验证码过期场景
密码重置流程
重置token盗用场景

自动化测试示例：

@Test fun `register with new email should succeed`() = runTest { val email = "test_${System.currentTimeMillis()}@example.com" val password = "StrongPass123!" val response = authApi.register(RegisterRequest(email, password)) assertThat(response.isSuccessful).isTrue() assertThat(userRepository.findByEmail(email)).isNotNull() } @Test fun `register with existing email should fail`() = runTest { val email = "existing@example.com" val password = "StrongPass123!" // 第一次注册应该成功 authApi.register(RegisterRequest(email, password)) // 第二次注册应失败 val response = authApi.register(RegisterRequest(email, password)) assertThat(response.code()).isEqualTo(HttpStatus.CONFLICT.value()) }

6.2 邮件送达验证

测试邮箱配置：

spring: mail: host: smtp.mailtrap.io port: 2525 username: your-mailtrap-user password: your-mailtrap-pass properties: mail.smtp.auth: true mail.smtp.starttls.enable: true

邮件测试策略：

使用Mailtrap等测试SMTP服务
检查邮件内容渲染效果
验证链接点击后的行为
测试垃圾邮件评分（使用如Mail-Tester.com）

7. 性能优化实践

7.1 数据库优化

用户表索引设计：

CREATE TABLE users ( id BIGSERIAL PRIMARY KEY, email VARCHAR(255) NOT NULL UNIQUE, password VARCHAR(255) NOT NULL, enabled BOOLEAN NOT NULL DEFAULT false, verification_code VARCHAR(64), reset_token VARCHAR(64), reset_token_expiry TIMESTAMP, created_at TIMESTAMP NOT NULL DEFAULT NOW(), updated_at TIMESTAMP NOT NULL DEFAULT NOW() ); CREATE INDEX idx_users_email ON users(email); CREATE INDEX idx_users_reset_token ON users(reset_token);

7.2 缓存策略

验证码缓存实现：

@Cacheable(value = "verificationCodes", key = "#email") public String generateVerificationCode(String email) { return UUID.randomUUID().toString(); } @CacheEvict(value = "verificationCodes", key = "#email") public void verifyEmail(String email, String code) { // 验证逻辑 }

7.3 异步处理

使用@Async发送邮件：

@Async @Override public void sendVerificationEmail(String to, String code) { // 邮件发送实现 }

配置线程池：

@Configuration @EnableAsync public class AsyncConfig { @Bean(name = "mailTaskExecutor") public Executor mailTaskExecutor() { ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor(); executor.setCorePoolSize(5); executor.setMaxPoolSize(10); executor.setQueueCapacity(100); executor.setThreadNamePrefix("mail-sender-"); executor.initialize(); return executor; } }

8. 国际化支持

8.1 多语言邮件模板

资源文件结构：

resources/ templates/ emails/ verification/ verification_en.html verification_zh.html reset-password/ reset_en.html reset_zh.html

根据语言选择模板：

String templateName = "emails/verification/verification_" + locale.getLanguage() + ".html"; String htmlContent = templateEngine.process(templateName, context);

8.2 错误消息国际化

消息资源文件：

# messages.properties error.email.exists=Email already registered error.email.invalid=Invalid email format error.password.weak=Password does not meet requirements # messages_zh.properties error.email.exists=邮箱已被注册 error.email.invalid=邮箱格式不正确 error.password.weak=密码不符合要求

异常处理：

@ExceptionHandler(EmailAlreadyExistsException.class) public ResponseEntity<ErrorResponse> handleEmailExists(EmailAlreadyExistsException ex) { String message = messageSource.getMessage("error.email.exists", null, LocaleContextHolder.getLocale()); return ResponseEntity.status(HttpStatus.CONFLICT).body(new ErrorResponse(message)); }

9. 监控与日志

9.1 关键指标监控

Prometheus指标：

@Bean public MeterRegistryCustomizer<PrometheusMeterRegistry> metricsCommonTags() { return registry -> registry.config().commonTags( "application", "auth-service" ); } @Autowired private MeterRegistry meterRegistry; public void registerUser() { Counter.builder("user.registration") .tag("type", "email") .register(meterRegistry) .increment(); }

9.2 结构化日志

Logback配置：

<appender name="JSON" class="ch.qos.logback.core.ConsoleAppender"> <encoder class="net.logstash.logback.encoder.LogstashEncoder"> <fieldNames> <timestamp>time</timestamp> <message>msg</message> <thread>thread</thread> <logger>logger</logger> <level>level</level> <stackTrace>stack_trace</stackTrace> </fieldNames> </encoder> </appender>

关键日志示例：

logger.info("User registered", StructuredArguments.keyValue("email", email), StructuredArguments.keyValue("source", "email"));

10. 部署注意事项

10.1 环境变量配置

敏感信息管理：

# .env 示例 SMTP_HOST=smtp.sendgrid.net SMTP_PORT=587 SMTP_USER=apikey SMTP_PASSWORD=your-sendgrid-key JWT_SECRET=your-256-bit-secret

Spring Boot配置：

spring: mail: host: ${SMTP_HOST} port: ${SMTP_PORT} username: ${SMTP_USER} password: ${SMTP_PASSWORD}

10.2 健康检查端点

Spring Boot Actuator配置：

management: endpoints: web: exposure: include: health,metrics,info endpoint: health: show-details: always probes: enabled: true

自定义健康检查：

@Component public class EmailServiceHealthIndicator implements HealthIndicator { private final JavaMailSender mailSender; @Override public Health health() { try { mailSender.testConnection(); return Health.up().build(); } catch (Exception e) { return Health.down() .withDetail("error", e.getMessage()) .build(); } } }

11. 移动端优化技巧

11.1 自动填充支持

AndroidManifest配置：

<activity android:name=".ui.auth.RegisterActivity" android:windowSoftInputMode="adjustResize"> <intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="https" android:host="yourapp.com" android:pathPrefix="/register" /> </intent-filter> </activity>

输入字段配置：

<EditText android:id="@+id/emailEditText" android:inputType="textEmailAddress" android:autofillHints="emailAddress" android:importantForAutofill="yes" />

11.2 深度链接处理

密码重置链接处理：

@Composable fun ResetPasswordScreen(navController: NavController) { val uri = LocalContext.current as? Activity ?.intent?.data ?: return val token = uri.getQueryParameter("token") ?: "" // 使用token验证并显示重置表单 }

12. 替代方案对比

12.1 邮件服务提供商对比

服务商	免费额度	送达率	易用性	适合场景
SendGrid	100封/天	★★★★★	★★★★	生产环境
Mailjet	200封/天	★★★★☆	★★★★	中小项目
Amazon SES	62,000封/月	★★★★★	★★★☆	大规模
Mailtrap	无限(仅测试)	-	★★★★★	开发测试

12.2 验证方式对比

方式	安全性	用户体验	实现复杂度	成本
邮件链接	★★★★☆	★★★☆☆	★★★☆☆	低
邮件验证码	★★★☆☆	★★★★☆	★★☆☆☆	低
SMS验证码	★★★★☆	★★★★★	★★★☆☆	中
人工审核	★★★★★	★☆☆☆☆	★★★★★	高

13. 扩展功能思路

13.1 邮箱别名支持

允许用户注册时使用邮箱别名（如user+alias@domain.com），服务端自动去除后缀：

public String normalizeEmail(String email) { return email.replaceAll("(?i)\\+[^@]+@", "@"); }

13.2 密码强度可视化

客户端实时显示密码强度：

@Composable fun PasswordStrengthIndicator(password: String) { val strength = calculateStrength(password) Box(modifier = Modifier.fillMaxWidth().height(4.dp)) { LinearProgressIndicator( progress = strength.strength, color = when { strength.strength < 0.3 -> Color.Red strength.strength < 0.7 -> Color.Yellow else -> Color.Green }, modifier = Modifier.fillMaxSize() ) } }

13.3 账户安全通知

密码修改后发送通知邮件：

@EventListener public void handlePasswordChangeEvent(PasswordChangeEvent event) { String ip = event.getIpAddress(); String device = event.getDeviceInfo(); Map<String, Object> model = new HashMap<>(); model.put("ip", ip); model.put("device", device); model.put("time", LocalDateTime.now()); emailService.sendTemplateEmail( event.getEmail(), "password-change-notification", model ); }

14. 常见问题排查

14.1 邮件未送达

检查清单：

检查SMTP服务商发送配额
验证SPF/DKIM/DMARC记录
检查垃圾邮件文件夹
测试不同邮箱提供商（Gmail/Outlook/QQ等）

14.2 验证链接失效

可能原因：

链接有效期设置过短
服务器时间不同步
用户多次点击生成新token
URL编码问题

14.3 高延迟问题

优化方向：

将邮件发送移出主流程（使用队列）
预生成验证码减少数据库写入
使用CDN托管静态邮件资源
启用HTTP/2减少网络延迟

15. 安全审计要点

15.1 渗透测试项目

必测项目：

验证码爆破测试
重置token预测
邮件头注入测试
跨站脚本攻击(XSS)
点击劫持防护

15.2 OWASP检查项

确保使用HTTPS
实施CSRF防护
密码哈希使用强算法
错误消息不泄露敏感信息
会话管理安全

16. 成本控制策略

16.1 邮件服务成本优化

使用SES的发送池功能
对非关键邮件降低优先级
压缩邮件中的图片资源
设置合理的发送速率限制

16.2 基础设施优化

使用Spot实例处理后台任务
对验证码使用内存数据库
启用自动缩放策略
使用云函数处理峰值负载

17. 用户体验优化

17.1 进度反馈设计

注册流程状态机：

sealed class RegisterState { object Idle : RegisterState() object Validating : RegisterState() data class Success(val email: String) : RegisterState() data class Error(val message: String) : RegisterState() }

17.2 自动跳转优化

验证成功后自动跳转并携带状态：

@Composable fun EmailVerifiedScreen(navController: NavController) { LaunchedEffect(Unit) { delay(2000) // 显示2秒成功状态 navController.navigate("home") { popUpTo("auth") { inclusive = true } } } Box(modifier = Modifier.fillMaxSize()) { Text("邮箱验证成功，即将跳转...") } }

18. 数据分析集成

18.1 关键指标追踪

注册漏斗分析：

fun trackRegistrationStep(step: String) { Firebase.analytics.logEvent("registration_step", bundleOf( "step" to step, "timestamp" to System.currentTimeMillis() )) }

18.2 转化率优化

A/B测试配置：

@Composable fun RegisterButton(variant: String, onClick: () -> Unit) { when (variant) { "A" -> FilledButton(onClick = onClick) { Text("立即注册") } "B" -> OutlinedButton(onClick = onClick) { Text("免费加入") } } }

19. 无障碍访问支持

19.1 Android无障碍优化

<EditText android:id="@+id/emailEditText" android:labelFor="@id/emailLabel" android:importantForAccessibility="yes" android:contentDescription="请输入注册邮箱地址" tools:ignore="HardcodedText" />

19.2 邮件内容无障碍

语义化HTML结构：

<h1 aria-label="邮箱验证通知">请验证您的邮箱</h1> <p id="instruction">点击下方按钮完成注册：</p> <a href="#" aria-describedby="instruction">验证邮箱</a>

20. 法律合规要点

20.1 GDPR合规措施

注册时明确用户协议和隐私政策
提供数据导出和删除功能
记录用户同意证据
设置数据保留期限

20.2 数据存储规范

密码必须加密存储
敏感操作日志保留6个月以上
实施数据分类分级
定期安全审计

21. 持续改进方向

21.1 技术债管理

技术债项：
- 密码策略可配置化
- 多因素认证支持
- 生物识别集成

21.2 用户反馈循环

注册失败时收集上下文信息
设置反馈入口
监控应用商店评论
定期用户访谈

22. 团队协作建议

22.1 API文档规范

Swagger示例：

@Operation(summary = "用户注册") @ApiResponses(value = { @ApiResponse(responseCode = "200", description = "注册成功"), @ApiResponse(responseCode = "400", description = "无效请求"), @ApiResponse(responseCode = "409", description = "邮箱已存在") }) @PostMapping("/register") public ResponseEntity<?> register(@RequestBody RegisterRequest request) { // 实现 }

22.2 代码审查要点

安全检查清单：
- 无敏感信息硬编码
- 密码加密验证
- 输入参数过滤
- 错误处理安全
性能检查项：
- 无N+1查询
- 合理使用缓存
- 批量操作支持

23. 灾难恢复方案

23.1 数据备份策略

用户数据库每日全量备份
验证码缓存多AZ部署
邮件服务多区域故障转移

23.2 应急预案

注册服务不可用：

降级为仅第三方登录
显示维护页面
启用排队机制

24. 监控告警配置

24.1 关键告警项

注册失败率 > 5%
邮件发送延迟 > 10s
验证码验证失败率突增
同一IP异常注册行为

24.2 Prometheus告警规则

groups: - name: auth.rules rules: - alert: HighRegistrationFailure expr: rate(auth_registration_failed_total[5m]) / rate(auth_registration_attempts_total[5m]) > 0.05 for: 10m labels: severity: warning annotations: summary: "High registration failure rate" description: "Current failure rate is {{ $value }}"

25. 技术演进路线

25.1 短期优化

密码策略可视化配置
注册数据分析看板
自动化测试覆盖率提升

25.2 长期规划

WebAuthn无密码支持
基于行为的异常检测
多因素认证集成
分布式锁服务引入

26. 性能基准测试

26.1 测试环境

4核8G云服务器
PostgreSQL 14
100Mbps网络带宽
JMeter测试工具

26.2 测试结果

场景	吞吐量 (req/s)	平均延迟	99分位延迟
注册接口	1,200	45ms	120ms
验证码验证接口	2,800	22ms	65ms
密码重置接口	950	60ms	150ms

27. 移动端兼容性

27.1 键盘优化

@Composable fun EmailInput() { val focusManager = LocalFocusManager.current OutlinedTextField( keyboardOptions = KeyboardOptions( imeAction = ImeAction.Next, keyboardType = KeyboardType.Email ), keyboardActions = KeyboardActions( onNext = { focusManager.moveFocus(FocusDirection.Down) } ) ) }

27.2 深色模式支持

@Composable fun AuthScreen() { val isDark = isSystemInDarkTheme() Surface(color = if (isDark) Color.DarkGray else Color.White) { // 内容 } }

28. 第三方服务集成

28.1 reCAPTCHA集成

后端验证：

public boolean verifyRecaptcha(String token, String ip) { String url = "https://www.google.com/recaptcha/api/siteverify"; String params = "secret=your_secret&response=" + token + "&remoteip=" + ip; String response = restTemplate.postForObject(url, params, String.class); return JsonPath.read(response, "$.success"); }

28.2 风险检测服务

public RiskLevel checkRegistrationRisk(String ip, String email) { FraudDetectionRequest request = new FraudDetectionRequest(ip, email); FraudDetectionResponse response = riskServiceClient.detect(request); return response.getRiskLevel(); }

29. 本地开发配置

29.1 开发环境简化

application-dev.yml：

spring: mail: host: localhost port: 1025 properties: mail.smtp.auth: false features: email-verification: enabled: false password-policy: enabled: false

29.2 邮件预览工具

使用MailHog作为本地SMTP服务器：

services: mailhog: image: mailhog/mailhog ports: - "1025:1025" - "8025:8025"

30. 生产环境部署

30.1 Kubernetes配置

Deployment示例：

apiVersion: apps/v1 kind: Deployment metadata: name: auth-service spec: replicas: 3 selector: matchLabels: app: auth-service template: spec: containers: - name: auth image: your-registry/auth-service:1.0.0 envFrom: - secretRef: name: smtp-credentials resources: limits: cpu: "1" memory: 1Gi

30.2 自动伸缩策略

apiVersion: autoscaling/v2 kind: HorizontalPodAutoscaler metadata: name: auth-service-hpa spec: scaleTargetRef: apiVersion: apps/v1 kind: Deployment name: auth-service minReplicas: 2 maxReplicas: 10 metrics: - type: Resource resource: name: cpu target: type: Utilization averageUtilization: 70

31. 迁移策略

31.1 从手机号迁移

分阶段引导用户绑定邮箱
提供账号合并功能
保持双因素验证过渡期
数据迁移脚本示例：

UPDATE users SET email = CONCAT(phone, '@migrated.com') WHERE email IS NULL;

31.2 数据库升级

Flyway迁移脚本：

-- V2__add_email_verification.sql ALTER TABLE users ADD COLUMN verified BOOLEAN DEFAULT false; CREATE INDEX idx_users_verified ON users(verified);

32. 废弃策略

32.1 旧API淘汰

标记为@Deprecated
返回Warning头
文档明确弃用时间
监控调用量下降情况

32.2 数据归档

-- 将6个月未活跃用户移至归档表 INSERT INTO users_archive SELECT * FROM users WHERE last_login_at < NOW() - INTERVAL '6 months'; DELETE FROM users WHERE id IN (SELECT id FROM users_archive);

33. 文档与知识共享

33.1 接口文档

OpenAPI示例：

paths: /register: post: tags: [Authentication] summary: 用户注册 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RegisterRequest' responses: 200: description: 注册成功

33.2 故障手册

典型故障处理：

邮件队列积压：
- 检查SMTP服务状态
- 临时增加消费者实例
- 限制非关键邮件发送
验证码服务超时：
- 检查缓存集群健康状态
- 降级为数据库存储
- 增加本地缓存层

34. 成本监控

34.1 邮件费用告警

-- 每日邮件发送量监控 SELECT date_trunc('day', sent_at) AS day, COUNT(*) AS count, COUNT(DISTINCT recipient) AS unique_recipients FROM email_logs GROUP BY 1 ORDER BY 1 DESC;