错误及问题排除
本章汇总 Weincloud 账号与登录相关的常见问题，说明每个现象的原因、判断依据与处置方式，帮助用户与管理员在无法登录或操作被拒绝时快速定位原因。
适用对象与范围：
- 普通用户：登录失败、忘记密码、收不到验证邮件、多因素验证（MFA）异常等自助排查。
- Domain Superuser 与 Subdomain Superuser：协助成员解除账号锁定、重置 MFA、确认 Domain 级别策略是否为问题来源。
- 本章不包含 HMI 激活与授权、EasyAccess 2.0 连线、Dashboard 项目等错误；该类问题请参阅对应章节。
错误消息的呈现方式
判断问题前，先确认消息出现在哪一层，可缩小排查范围：
| 呈现方式 | 来源 | 特征 |
|---|---|---|
| 字段下方的红色提示 | 浏览器端的格式检查 | 尚未提交请求，仅代表字段格式不符 |
| 浮动提示消息（Toast） | 服务器返回的错误 | 显示约 5 秒后自动消失，内容即为实际失败原因 |
| 对话框或系统提示 | 需用户确认才能继续的事件 | 例如会话过期，确认后强制跳转回登录页 |
| 独立错误页面 | 路由级别的访问失败 | 显示 403、404、503 等状态码 |
部分错误除了显示消息外，还会自动跳转到其他页面（例如密码强度不足时跳转至密码重置页）。若页面在提示后自行跳转，属预期行为，请按跳转后的页面完成处置。
无法登录
登录页需输入〔Domain〕、〔用户名〕与〔密码〕三项信息。管理员账号的用户名固定为 admin。
提交前，浏览器会先检查下列条件，未通过时不会提交请求：
- 三个字段均为必填。
- 密码至少 6 个字符，字段可输入的上限为 16 个字符。
通过字段检查后仍失败时，按服务器返回的消息判断原因：
| 消息 | 原因 | 处置 |
|---|---|---|
| 此 Domain 名称不存在 | Domain 名称拼写错误，或该 Domain 尚未创建 | 确认 Domain 名称；Domain 名称长度为 4–32 个字符，仅含英文字母、数字与下划线 |
| 用户不存在 | 该 Domain 下没有此用户名 | 确认用户名；管理员账号为 admin。用户名长度为 4–32 个字符 |
| 密码错误 | 密码不正确 | 重新输入。连续失败会触发锁定，见账号被锁定 |
| Domain 尚未确认 | 注册后未完成电子邮件确认 | 见账号尚未完成验证 |
若确认三项信息均正确仍无法登录，依序检查下列各节的限制条件。
账号被锁定
连续验证失败达到阈值时，账号会被锁定，此后即使输入正确的密码或验证码也无法登录。
密码与**验证码（OTP）**分别计数，两者阈值独立，达到任一阈值即触发锁定。该阈值为系统固定值，不随 Domain 的策略而改变：
| 验证类型 | 触发阈值 |
|---|---|
| 密码 | 连续失败 20 次 |
| 验证码（OTP） | 连续失败 5 次 |
验证码的计数涵盖所有输入 6 位数验证码的环节，包含〔双因素验证〕页面与电子邮件验证码登录。因此账号可能在密码完全正确的情况下，仅因验证码反复输入错误而被锁定。
锁定的解除方式则由该 Domain 的〔失败尝试策略〕决定：
| 策略 | 提示消息 | 解除方式 |
|---|---|---|
| 〔预设〕 | 您的帐号已被临时锁定，请于 30 分钟后重试。 | 锁定 30 分钟，超时自动解除 |
| 〔严格〕 | 登录错误次数已达上限，请联系管理员解除锁定。 | 不会自动解除，须由管理员手动解除 |
策略为 Domain 级别设置，应用于该 Domain 下的所有用户，设置方式见设置－失败尝试策略。该 Domain 保持〔未设置〕时，锁定保护仍然生效，行为同〔预设〕。
admin 账号的例外
用户名为 admin 的账号不适用〔严格〕策略的持续锁定。无论该 Domain 设置为何种策略，admin 触发锁定后一律为临时锁定 30 分钟，超时自动解除，无须他人协助解锁。
处置方式：
- 〔预设〕策略：等待 30 分钟后重试。若不确定正确密码，直接改用密码重置流程，重置成功后锁定即解除，无须等待。
- 〔严格〕策略：完成密码重置即可自行解除锁定；无法使用密码重置时，联系该 Domain 的 Domain Superuser，在〔User〕页面对该账号执行〔解除锁定〕。此操作仅 Domain Superuser 可执行，且仅在账号当前处于锁定状态时才会出现，详见用户管理。
admin账号：无论策略为何，等待 30 分钟后即可重试，处理方式同〔预设〕策略。- 因验证码错误而锁定：解除方式与上述相同。解除后请先按多因素验证（MFA）问题确认可正常获取验证码，再重新登录，避免再次触发锁定。
登录 IP 不在允许范围
页面显示「此 IP 不允许登录」时，代表该账号已设置登录 IP 限制，而当前的连线来源不在允许的 IP 范围内。此限制仅适用于用户名为 admin 的账号。
处置方式：
- 改由允许的网络环境登录，例如公司内网或指定站点。
- 需调整允许范围时，须先从允许范围内的来源登录，再在〔Profile〕页面的〔登录 IP 限制〕修改，详见账号设置－登录 IP 限制。
设置登录 IP 限制前，请确认列表已包含当前使用的 IP，否则保存后将无法从该处登录。
密码强度未达要求
Domain 启用〔密码强度〕后，既有密码不会立即失效，而是在下次登录时检查。若现有密码不符合要求，系统显示「密码强度未达安全要求，请立即变更密码」并自动跳转至密码重置页面，须完成更改后方可继续使用。
此情况下的新密码要求较平时严格：最短长度由 6 个字符提高为 8 个字符，且须同时包含大写字母、小写字母、数字与特殊字符。策略说明见设置－密码强度。
账号尚未完成验证
新注册的 Domain 须完成电子邮件确认才能登录。注册完成后，系统会将确认邮件发送至注册时填写的电子邮件地址，点击邮件中的链接即完成激活。
未完成确认即登录时，页面显示「Domain 尚未确认」。处置方式：
- 检查注册邮箱的收件箱与垃圾邮件箱。
- 未收到邮件时，在登录页点击〔尚未收到认证邮件〕，输入 Domain 与用户名后点击〔发送〕，系统重新发出验证链接。
- 若点击链接后显示「链接已过期」，代表该链接无效或已逾期，请按上一步重新获取新的验证链接。
注册流程详见开始使用 Weincloud。
隐私政策已更新
隐私政策更新后，系统会在登录时要求重新同意，消息为「我们已更新隐私权政策，请同意后继续使用 Weincloud」。按页面提示阅读并同意后即可继续使用；未同意前无法访问其他功能。
忘记密码与密码重置
密码重置同时是忘记密码与解除账号锁定的通用解法：重置成功后，锁定状态随即解除，且不受该 Domain 的〔失败尝试策略〕影响。
获取密码重置链接
- 在登录页点击〔忘记密码〕，打开〔重置密码〕对话框。
- 输入〔Domain〕与〔用户名〕，两个字段均为必填。
- 点击〔发送〕。提交成功后显示「密码重置邮件已发送。」，重置链接将发送至该账号的电子邮件地址。
若输入的 Domain 或用户名不存在，对话框不会关闭，并以提示消息说明失败原因，可修正后直接重试。
设置新密码
点击邮件中的链接进入〔重置密码〕页面，输入〔新密码〕与〔确认密码〕后点击〔设置新密码〕。
- 密码长度为 6–16 个字符；若本次重置是由密码强度策略触发，最短长度为 8 个字符。
- 两次输入的密码必须一致。
- 输入时，字段下方以四段式强度指示（〔弱〕、〔普通〕、〔良好〕、〔强〕）实时显示密码强度，供参考用。
完成后页面显示「您的密码已更新，现在可以使用新密码登录。」并返回登录页，须以新密码登录。
重置失败的处理
| 现象 | 原因 | 处置 |
|---|---|---|
打开链接后显示 404 页面 | 网址缺少重置用的令牌，通常是链接被截断或未完整复制 | 从邮件中重新点击完整链接，或重新申请一次重置邮件 |
| 点击〔设置新密码〕后显示错误消息 | 重置链接已逾期或已使用过 | 重新申请一次重置邮件；每封重置邮件仅供一次使用 |
| 收不到重置邮件 | 见收不到系统邮件 | — |
收不到系统邮件
Weincloud 以电子邮件发送注册确认邮件、密码重置邮件与验证码。收不到邮件时依序检查：
- 确认收件位置：验证邮件与重置邮件发送至该账号注册的电子邮件地址，并非登录时输入的用户名。
- 检查垃圾邮件箱：系统邮件可能被归类为垃圾邮件。
- 确认发送频率限制：验证码的重新发送有间隔限制，过于频繁时会显示「您可以在 60 秒后重新发送验证码」，须等待倒计时结束。
- 确认验证码未过期：验证码有有效期限，逾期使用会显示「验证码已过期」，须重新获取。
- 确认电子邮件地址正确：登录后可在〔Profile〕页面查看与变更电子邮件地址，并确认其验证状态，详见账号设置－电子邮件。
若账号的电子邮件地址已无法收信且尚未变更，须联系该 Domain 的 Domain Superuser 协助处理。
多因素验证（MFA）问题
启用 MFA 后，通过密码验证会进入〔双因素验证〕页面，须输入 6 位数验证码才完成登录。验证码的来源按所选方式而定：〔Email OTP〕发送至注册的电子邮件；〔Email + TOTP App〕由验证器 App 生成，并以电子邮件作为备用。
| 现象 | 处置 |
|---|---|
| 收不到电子邮件验证码 | 点击〔重新发送验证码〕；按钮在倒计时结束前为禁用状态，须等待倒计时完成。并按收不到系统邮件检查 |
| 验证器 App 的验证码一直验证失败 | TOTP 验证码具时效性，请确认设备时间为自动校时且时区正确，再重新获取验证码 |
| 更换手机或丢失验证器 App | 〔Email + TOTP App〕以电子邮件作为备用，可改由电子邮件接收验证码登录；登录后在〔Profile〕页面重新设置 MFA 以绑定新设备 |
| 电子邮件与验证器 App 均无法使用 | 联系该 Domain 的 Domain Superuser，在〔User〕页面对该账号执行〔重置 MFA〕。此操作仅 Domain Superuser 可执行，且仅在该用户已启用 MFA 时才会出现 |
| 无法选择〔Email OTP〕或〔Email + TOTP App〕 | 账号的电子邮件尚未验证。请先完成电子邮件验证，详见账号设置－验证电子邮件 |
| 反复输入错误后显示账号已锁定 | 验证码连续输入错误 5 次即锁定账号，阈值低于密码的 20 次。解除方式见账号被锁定 |
MFA 的设置方式与登录流程详见账号设置－多因素验证。
社交登录问题
以 Google、Microsoft、Apple、微信或电子邮件验证码登录时，可能出现下列情况：
| 消息或现象 | 原因 | 处置 |
|---|---|---|
| 此社交登录账号已关联到其他用户 | 一个 Weincloud 账号同时只能关联一组社交账号；要关联的账号已有社交关联 | 改以该账号原本关联的社交账号登录，或先在该账号的〔Profile〕页面解除关联后再重新关联 |
| 社交登录 Token 无效／已过期 | 授权流程超时，或授权页面停留过久 | 返回登录页重新执行一次社交登录 |
| 找不到社交登录状态 | 授权流程中途中断，例如刷新页面或使用浏览器后退 | 返回登录页重新执行，过程中请勿刷新或离开页面 |
| 电子邮件验证码显示已过期 | 一次性验证码有有效期限，页面上以倒计时秒数显示 | 点击〔重新发送验证码〕获取新的验证码 |
| 微信二维码显示已过期 | 二维码有有效期限 | 重新打开登录对话框以获取新的二维码 |
| 完成授权后显示〔选择账号〕且列表为空 | 该社交账号尚未关联任何 Weincloud 账号 | 按对话框提示〔创建新账号〕或〔关联现有账号〕 |
社交登录的机制、可用的提供方，以及社交身份与 Weincloud 账号的对应关系，见社交登录与社交登录－社交身份与 Weincloud 账号的对应关系。
TIP
可用的提供方由服务器决定：全球服务器提供 Email、Google、Microsoft 与 Apple；中国服务器提供 Email 与微信。
会话与被强制登出
登录后系统会自动维持会话，令牌到期时在后台更新，用户通常不会察觉。下列情况会中止会话：
| 现象 | 原因 | 处置 |
|---|---|---|
| 显示会话已过期的提示，确认后跳转回登录页 | 令牌已失效且无法自动更新，例如闲置过久 | 重新登录。系统会保留原本的页面地址，登录后自动返回该页 |
| 操作中突然被登出 | 该登录会话已在其他设备上被登出，或账号密码已变更 | 重新登录。可在〔Profile〕页面的〔登录会话〕查看当前有效的登录记录，详见账号设置－登录会话 |
| 变更密码后被要求重新登录 | 密码变更成功后强制重新登录 | 以新密码登录，属预期行为 |
| 登录后被跳转至〔Profile〕页面且无法前往其他页面 | 账号的电子邮件尚未验证，或账号正处于预约删除状态 | 完成电子邮件验证；账号预约删除中时可执行〔取消删除〕以恢复正常状态，详见账号设置－取消删除 |
发现非预期的登录记录时，建议立即执行〔全部登出〕、变更密码，并启用 MFA。
权限不足与页面访问错误
| 现象 | 原因 | 处置 |
|---|---|---|
| 显示「权限不足」、「您没有访问权限」或「权限检查失败」 | 当前账号的角色或文件夹范围不足以执行该操作 | 确认所需权限，并向 Domain Superuser 申请。权限模型见用户管理与Subdomain 的管理 |
| 菜单中看不到某个功能 | 菜单按账号权限动态显示，无权限的项目不会出现 | 同上，确认账号是否具备该功能所需权限 |
显示 403 错误页面 | 直接以网址访问无权限的页面 | 返回〔Directory〕页面，改由菜单进入有权限的功能 |
显示 404 错误页面 | 网址错误，或该资源已被删除 | 确认网址；若由书签或旧链接进入，请重新从菜单导航 |
管理者调整权限后，该用户需重新登录才会应用新的菜单与访问范围。
服务暂时不可用
| 消息或现象 | 原因 | 处置 |
|---|---|---|
| 您提交的请求过多 | 短时间内提交的请求超过服务器限制 | 停止重复操作，稍候再试。避免连续点击提交按钮 |
| 服务器不可用 | 服务器暂时无法响应 | 稍候再试；持续发生时联系客服 |
| 服务发生内部问题 | 服务器端异常 | 稍候再试；若持续失败，请记录操作步骤与时间并联系客服 |
显示 503 错误页面 | 服务器过载或正在维护 | 稍候再试 |
| 页面长时间无响应后失败 | 单个请求超时（上限 30 秒） | 缩小查询范围后重试，例如减少日期区间或筛选条件 |
限制与注意事项
| 项目 | 限制 |
|---|---|
| Domain 名称 | 4–32 个字符，仅含英文字母、数字与下划线 |
| 用户名 | 4–32 个字符；不可自行变更 |
| 密码长度 | 6–16 个字符；Domain 启用〔密码强度〕后最短为 8 个字符 |
| 登录失败锁定阈值 | 密码连续失败 20 次；验证码（OTP）连续失败 5 次，两者独立计数 |
| 锁定解除方式 | 〔预设〕锁定 30 分钟后自动解除；〔严格〕须管理员解除 |
| 〔严格〕策略适用范围 | 不适用于 admin；该账号一律锁定 30 分钟后自动解除 |
| 验证码重新发送 | 须间隔 60 秒 |
| 验证链接与验证码 | 具有效期限，逾期须重新获取；重置密码链接仅供一次使用 |
| 登录 IP 限制 | 仅用户名为 admin 的账号可用；最多 5 条；仅支持 IPv4 的 CIDR 格式 |
| 解除账号锁定、重置 MFA | 仅 Domain Superuser 可执行 |
| 单个请求超时 | 30 秒 |
常见问题
Q：账号被锁定后，等待多久会自动解除？
A：取决于该 Domain 的〔失败尝试策略〕。〔预设〕策略锁定 30 分钟后自动解除；〔严格〕策略不会自动解除，须由 Domain Superuser 手动解锁。两种策略的触发阈值相同，差异仅在于是否自动解除。
用户名为 admin 的账号是唯一例外：无论策略为何，一律锁定 30 分钟后自动解除。
Q：密码明明没输错，为什么账号会被锁定？
A：验证码（OTP）与密码分别计数，验证码连续输入错误 5 次即锁定账号，阈值远低于密码的 20 次。若验证器 App 时间未校准，或反复使用已过期的电子邮件验证码，很容易在密码完全正确的情况下触发锁定，见多因素验证（MFA）问题。
Q：忘记密码可以解除账号锁定吗？
A：可以。完成密码重置后锁定状态即解除，无须等待锁定时间结束。〔严格〕策略下同样适用，因此不一定要联系 Domain Superuser。
Q：忘记用户名或 Domain 名称怎么办？
A：管理员账号的用户名固定为 admin。其余账号请联系该 Domain 的 Domain Superuser 查询；密码重置与重发验证邮件均须同时提供 Domain 与用户名，无法仅以电子邮件地址进行。
Q：为什么输入正确密码仍显示密码错误？
A：请确认〔Domain〕字段正确。相同的用户名可能存在于不同 Domain，Domain 填错时系统会以另一个账号验证密码。此外请确认未开启大写锁定。
Q：为什么登录后被强制跳转至密码重置页面？
A：该 Domain 已启用〔密码强度〕，而当前密码不符合要求。请完成密码变更后再继续使用。
Q：管理员可以直接查看用户的密码吗？
A：不行。管理员只能在用户详细资料页为其重置密码，过程中须输入管理员本人的密码进行身份验证。