Davx5-OSE项目中Google登录自定义域名支持问题分析

在Davx5-OSE项目4.4.0.1版本中，用户报告了一个关于Google账户登录功能的重要问题。该问题影响了使用自定义域名邮箱（非@gmail.com结尾）的用户登录体验。

问题本质

核心问题出现在Google登录模块的邮箱地址处理逻辑上。在4.4.0.1版本中，代码对用户输入的邮箱地址进行了强制性的@gmail.com后缀追加处理。具体表现为：

val emailWithDomain = StringUtils.appendIfMissing(email, "@gmail.com")

这种处理方式会导致以下问题：

1. 当用户输入的是完整邮箱地址（如[e-mail]）时，系统仍会错误地追加@gmail.com后缀
2. 最终生成的错误地址格式为[e-mail]@gmail.com
3. 向Google API发送请求时，由于地址格式错误导致404响应

历史行为对比

在之前的版本中（如4.3.16），代码采用了更合理的处理逻辑：

val loginEmail = if (userEmail.contains('@')) userEmail else "$[e-mail]"

这种实现方式：

1. 首先检查邮箱地址是否已包含@符号
2. 如果包含则直接使用原地址
3. 否则才追加@gmail.com后缀

影响范围

该问题主要影响以下用户群体：

1. 使用Google Workspace（原G Suite）的企业用户
2. 使用自定义域名邮箱的Google账户
3. 任何非@gmail.com结尾的Google关联邮箱

临时解决方案

对于遇到此问题的用户，目前可行的临时解决方案是：

1. 降级到4.3.16版本
2. 等待官方修复版本发布

技术建议

从代码质量角度考虑，建议的修复方案应包括：

1. 恢复原有的@符号检查逻辑
2. 增加对已知Google域名（如gmail.com、googlemail.com）的检测
3. 考虑添加对Google Workspace常用域名的支持
4. 实现更完善的邮箱格式验证

用户体验改进

长期来看，可以考虑：

1. 在UI层面明确提示支持的邮箱类型
2. 为错误格式的邮箱提供即时反馈
3. 添加详细的错误说明，帮助用户理解问题原因

这个问题展示了在开发跨域账户系统时，正确处理各种邮箱格式的重要性，特别是在支持企业级应用场景时，需要特别考虑自定义域名的情况。