用户

登录、注册、账号认证等用户侧问题（含管理员账号登录）。相关能力见用户认证体系。

密码输错 5 次后被锁定，无法登录

用户连续输错密码达到 NUXT_LOGIN_MAX_ATTEMPTS 次（默认 5 次）后，账号会在 NUXT_LOGIN_LOCK_WINDOW 分钟内（默认 15 分钟）被临时锁定，期间无法登录。

• 原因：防止他人暴力尝试密码的安全保护机制，属于正常行为，不是账号故障。
• 解决：等待锁定时间结束再登录；或使用登录页「找回密码」重置密码（需要先配置 SMTP，见下文）。
• 调整阈值：NUXT_LOGIN_MAX_ATTEMPTS 和 NUXT_LOGIN_LOCK_WINDOW 在服务器 .env 中配置，修改后重启应用生效，见环境变量·安全策略。
• 建议：锁定期间不要反复尝试，先核对账号和密码是否输错。

找回密码或邮箱验证收不到邮件

先到 /admin/settings 的「邮件配置」完成 SMTP 配置并发送测试邮件。找回密码、注册邮箱验证和实名认证邮箱验证共用这套 SMTP 配置；未配置时，验证码不会送达。

检查 SMTP 主机、端口、账号、授权码（或应用专用密码）、发件人地址和 secure 设置。开发环境未配置 SMTP 时，可在服务端日志中查看邮件内容；生产环境应使用真实 SMTP，并检查服务端日志和邮件服务商的发送记录。

默认管理员无法登录

• 确认 NUXT_ADMIN_EMAIL / NUXT_ADMIN_PASSWORD 与登录所用一致。
• 首次启动自动创建；若该邮箱已是普通用户会被提权为 admin。
• 数据库中一旦已有管理员，修改环境变量并重建不会覆盖其密码。
• 已配置 SMTP 时使用登录页“忘记密码”。无法使用邮件恢复时，先备份数据库，再由有权限的技术人员执行账号恢复。