无法登录或恢复会话

登录依赖已完成的身份验证挑战和浏览器 Session Cookie。请先按实际使用的登录方式排查，不要连续申请多个验证码。

邮箱验证码

1. 核对完整邮箱，只使用最新邮件中的验证码。
2. 每次只申请一个，并在过期前输入；新验证码可能使旧验证码失效。
3. 若未收到邮件，部署可能使用只写服务器日志的开发邮件服务，或 ACS/SMTP 未配置。此时需要管理员检查邮件服务。
4. 验证成功后刷新 /app。若又回到 Login，请检查前端与 API 域名以及 Cookie 配置。

Passkey

非本地环境需要 HTTPS、受支持的验证器、用于短期 Challenge 的 Redis，以及与页面域名一致的 WebAuthn RP/origin 配置。若 Add passkey 失败，可在同一标签页重试一次；域名不匹配只能由运维修正。

Microsoft、Google 或 Lark

只使用当前登录页实际提供的服务商按钮。在授权页拒绝不会修改账号；可重新开始，或在页面提供邮箱登录时改用邮箱。如果回到 Formist 后出现账号关联确认，请验证你现有账户的邮箱，把这个身份关联到该账户。如果验证的邮箱没有对应账户，Formist 会询问你改用现有账户的邮箱还是创建新账户，不会悄悄创建账户。在部署提供时，已登录用户也可以在设置的安全下的登录方式中绑定 Lark。持续出现回调或服务商不可用错误时，需要运维检查凭据、Microsoft 云设置和精确回调地址。

联系支持时提供登录方式、时间、浏览器、错误提示，以及问题发生在验证前还是验证后。不要提供验证码、Cookie 或 Passkey 凭据。

Frequently asked questions

重新请求邮箱验证码会让已有的验证码失效吗？

会。再次请求验证码可能会让之前的验证码失效，因此应该只请求一次并在过期前输入，而不是连续请求多次。

为什么重新创建 Passkey 无法修复域名不匹配问题？

因为不匹配来自 WebAuthn RP/Origin 设置与页面域名不一致，而不是 Passkey 本身的问题，需要运维人员修正域名配置。

拒绝 Microsoft 或 Google 的授权确认会影响我的账号吗？

不会。拒绝授权确认不会改变任何账号状态；重新开始登录流程，或在提供该方式时改用邮箱登录即可。