Outline项目中的Google认证与已删除工作区用户冲突问题分析

问题背景

在Outline项目中，当用户尝试使用Gmail账号创建新账户时，系统会检查该邮箱是否已存在于任何工作区中。然而，当该邮箱存在于一个已被删除但尚未完全清除的工作区时（工作区删除后有30天的数据保留期），系统会抛出TeamDomainRequiredError错误，导致新账户创建失败。

技术原理

Outline的Google认证模块在处理用户注册时，会执行以下关键步骤：

1. 通过Google OAuth获取用户信息
2. 检查用户邮箱是否已存在于系统中
3. 如果存在，验证用户是否有权访问对应工作区
4. 如果不存在或无权访问，则创建新账户

问题出在第二步的检查逻辑中，当前实现没有考虑工作区的删除状态，导致对已删除工作区中的用户账号也进行了验证。

解决方案分析

要解决这个问题，需要在用户存在性检查阶段加入对工作区状态的判断：

1. 修改用户查询逻辑，排除属于已删除工作区的用户记录
2. 或者在验证工作区访问权限前，先检查工作区是否处于活跃状态
3. 对于已删除工作区中的用户账号，应视为"不存在"，允许创建新账户

实现建议

在代码层面，建议在plugins/google/server/auth/google.ts文件的第76行附近，修改用户查询逻辑，加入类似如下的条件判断：

const user = await User.findOne({
  where: {
    email: profile.email,
    teamId: {
      [Op.notIn]: await Team.findAll({
        where: { deletedAt: { [Op.not]: null } },
        attributes: ['id']
      })
    }
  }
});

这样就能确保查询结果中不包含属于已删除工作区的用户记录。

用户体验优化

从用户体验角度，这个修复将带来以下改进：

1. 用户不再会因为历史账号问题而无法注册
2. 系统行为更加符合用户预期
3. 减少了不必要的错误提示和用户困惑

总结

Outline项目中Google认证模块的用户存在性检查需要完善对工作区状态的判断，特别是在处理已删除工作区中的用户账号时。通过修改查询逻辑，可以避免TeamDomainRequiredError错误的不当抛出，提升用户注册体验。这个问题也提醒我们在设计用户系统时，需要考虑各种边缘情况，特别是涉及数据软删除的场景。