fix login error
This commit is contained in:
tamakyi
@@ -283,3 +283,100 @@ GOSUMDB=off GOFLAGS=-mod=mod` 就秒级完成。**
|
||||
### 备注
|
||||
- `route/user/profile.go` 的行尾是 **LF**（与「route/** 皆 CRLF」的旧印象不符，按文件单独确认即可）。
|
||||
|
||||
---
|
||||
|
||||
## 🔴 P0 修复：账号停用后同一邮箱/域名永远无法重新注册
|
||||
|
||||
用户在测试环境 `https://box-dev-api.337845818.best` 注册 `1223383917@qq.com` / `tamakyi` 报 500：
|
||||
```
|
||||
SELECT ... WHERE email = '...' AND deleted_at IS NULL -> rows:0
|
||||
INSERT INTO users ... -> ERROR: duplicate key value violates unique constraint "idx_users_email_unique" (SQLSTATE 23505)
|
||||
ERRO Failed to create new user error="create user: ERROR: duplicate key ..."
|
||||
```
|
||||
|
||||
### 根因（本地已实测复现，日志形态与线上一致）
|
||||
`internal/db/users.go` 的 `Deactivate` 用的是 **GORM 默认的软删除**：
|
||||
`db.WithContext(ctx).Model(&User{}).Delete("id = ?", u.ID)` → 只写 `deleted_at`，**行仍在库里**。
|
||||
而 `User` 的 `email` / `domain` 是 `uniqueIndex`（**索引不含 deleted_at**），于是：
|
||||
- 查重 `validate()` 走 gorm 软删除作用域 → 看不见这行 → 放行；
|
||||
- INSERT 被数据库唯一索引拦下 → `Create` 的 TOCTOU 兜底再查一次仍看不见 → 抛底层 23505 → handler `default` 分支 → 500。
|
||||
|
||||
复现证据（临时测试，已删）：停用后 `Unscoped` 查该邮箱 → 行仍在且 `deleted_at.Valid=true`；同邮箱重新注册 → 与线上同样的 23505。
|
||||
**旁证**：`internal/cmd/ban.go:64` 早有注释「用 Unscoped 查找，支持封禁已软删除（自助停用）的账号」——
|
||||
说明「自助停用会留软删除行」是既有事实，但没人把「唯一索引占位」这层后果接上。
|
||||
同类先例：`internal/db/vote_submissions.go:234` 已因同一原因改用 Unscoped 物理删除。
|
||||
|
||||
顺带发现：`BanUserAndCleanup` 的「连带清理」也只是软删除子表（Question/FollowUp/Conversation/Message… 都嵌 `dbutil.Model`），
|
||||
数据实际仍在库；也与停用页「所有数据将被删除」的承诺不符。
|
||||
|
||||
### 改动（`internal/db/users.go`）
|
||||
1. `Deactivate` → 调 `db.purgeUser(ctx, u.ID)`；`BanUserAndCleanup` 同样委托给它。
|
||||
2. 抽私有 `purgeUser`：级联删除**全部改为 `Unscoped()` 物理删除**（追问/消息/消息图片/会话/提问-图片关联/提问/拉黑/功能开关/用户行）。
|
||||
3. `Create` 兜底加固：唯一键冲突且 `validate` 仍查不到时，用新增的 `duplicateFieldErr()`（Unscoped）判定是 email 还是 domain 被占，
|
||||
返回 `ErrDuplicateEmail`/`ErrDuplicateDomain` 友好提示，而不是把 23505 抛成 500。（`isDuplicateKeyError` 复用 vote_submissions.go 里的）
|
||||
4. 回归测试 `TestDeactivatePurgesUser`：停用后 Unscoped 也查不到用户行、提问被清理、同一邮箱可重新注册。
|
||||
|
||||
### ⚠️ 过程中自己踩的 GORM 大坑
|
||||
把级联删除改成「先 `tx = tx.WithContext(ctx).Unscoped()` 再逐条 `tx.Where(...)`」——
|
||||
**事务句柄 clone==0，复用同一个句柄会让上一条语句的 `Where` 条件串到下一条上**，
|
||||
SQL 变成 `DELETE FROM follow_ups WHERE <follow_ups条件> AND <messages条件>` → `字段 conversation_id 不存在 (42703)`。
|
||||
✅ 正确写法：**每条语句都重新取句柄** `tx.WithContext(ctx).Unscoped().Where(...)`（原代码本来就是每条 `tx.WithContext(ctx)`，是我改坏的）。
|
||||
这条已写进 MEMORY.md。
|
||||
|
||||
### 验证
|
||||
- `go build ./...` / `go vet ./...` EXIT=0；`go test ./...`（含本地 PG）**全绿**；gofmt clean；行尾未变（users.go CRLF、users_test.go LF）。
|
||||
- 测试环境实测（脚本 `dev/devcheck-e2e.py`）：
|
||||
- ✅ 注册 / 登录 / `/user/profile` / `/user/questions` / `/user/votes`(302→`/user/questions#votes`) / 提问（返回提问成功页）/ 新建投票页 / 停用页 / **停用后跳 `/deactivated` 成功页** 全部正常；
|
||||
- ✅ `/deactivated` 四语言标题渲染正确（账号已停用 / 帳號已停用 / Account deactivated / アカウントを停止しました）；
|
||||
- ❌ **停用后同邮箱重新注册仍 500** —— 测试环境跑的是**旧构建**（`/deactivated` 已在，但没有 purgeUser 修复），需重新部署。
|
||||
- ⚠️ 测试环境 DB 里已留下本次测试产生的孤儿行，需清理：
|
||||
`tbe2e0915122816@example.com`（仍在线）、`tbe2e0915122934@example.com`、`tbcheck0915122657@example.com`（均已停用=软删除占位）；
|
||||
用户自己的 `tamakyi` / `1223383917@qq.com` 同样是软删除占位（这就是他报错的直接原因）。
|
||||
清理方式：`tamabox ban --email <邮箱> --yes`（CLI 支持查软删除账号），或直接 SQL 删 `users.deleted_at IS NOT NULL` 的行。
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 方案变更（覆盖上一节）：停用改为「保留身份占位 + 清空内容」
|
||||
|
||||
用户表示**尚未部署**，并提出：「曾经注册过的账户停用后，再次注册时应提示『该邮箱已被占用但账户已停用，如需重新使用请联系站长』」。
|
||||
经询问确认两点：
|
||||
1. 停用形态 = **保留身份占位**（用户行软删除）+ **物理删除内容数据**（停用页「所有数据将被删除」的承诺仍然成立）；
|
||||
2. 「联系站长」**复用页脚已有的「找站长」入口**（`site.footer.admin` → `https://box.shiroko.one/_/tamakyi`），不新增站长邮箱配置项。
|
||||
|
||||
→ **上面「Deactivate 改成物理删除」的做法已被取代**，但其中「级联内容必须 Unscoped 物理删除」的结论仍然有效。
|
||||
|
||||
### 最终实现
|
||||
- `internal/db/users.go`
|
||||
- `purgeUserContent(ctx, tx, userID)`（包级函数）：把内容级联删除抽出来，全部 `Unscoped()` 物理删除。
|
||||
- `Deactivate` = `purgeUserContent` + **软删除用户行**（保留 email/domain 占位）。
|
||||
- `BanUserAndCleanup` = `purgeUserContent` + **物理删除用户行**（唯一差别；彻底释放邮箱/域名）。
|
||||
- `validate` 重写为两轮：先查活跃账号（ErrDuplicateEmail/Domain），再 **Unscoped** 查已停用占位行
|
||||
→ 新增 `ErrDeactivatedEmail` / `ErrDeactivatedDomain`；辅助方法 `fieldTaken(ctx, column, value, includeDeleted)`。
|
||||
- 新增 `Reactivate(ctx, id)`（清 `deleted_at`，未停用时返回 ErrUserNotExists），已加进 `UsersStore` 接口。
|
||||
- 上一轮加的 `duplicateFieldErr` 已删除：`validate` 现在本身就覆盖了软删除行，无需在 Create 兜底里重复判定。
|
||||
- `route/auth/register.go`：把两个新错误映射到 `auth.errDeactivatedEmail` / `auth.errDeactivatedDomain`。
|
||||
- i18n ×4：新增 `auth.errDeactivatedEmail`、`auth.errDeactivatedDomain`、`deactivate.note`（键集合保持一致）。
|
||||
- `templates/user/deactivate.html`：desc 下方加一行 `deactivate.note`（uk-text-small uk-text-muted），
|
||||
提前告知「邮箱/域名会作为身份占位保留，无法用同一邮箱重新注册，如需恢复请找站长」。
|
||||
- **新增 CLI `internal/cmd/restore.go`（`TamaBox restore`）**：`--email|--domain [--password] [--yes]`，
|
||||
清掉 deleted_at 完成恢复；`--password` 会重置密码（必须先恢复再改密码——`UpdatePassword` 走普通作用域）。
|
||||
|
||||
### 🐛 顺带修掉的隐藏问题
|
||||
**`cmd/tamabox.go` 里根本没注册 `cmd.Ban`** —— `internal/cmd/ban.go` 写了但命令不可达（`TamaBox ban` 不存在）。
|
||||
现已把 `cmd.Ban` 与 `cmd.Restore` 一起注册进 `app.Commands`。
|
||||
|
||||
### 验证
|
||||
- `go build ./...` / `go vet ./...` EXIT=0；`go test ./...`（含本地 PG）**全绿**；gofmt 全部 clean；行尾未变。
|
||||
- 新增/改写测试：`TestDeactivatePurgesUser`（占位行保留 + 内容清空 + 同邮箱得 ErrDeactivatedEmail + 同域名得
|
||||
ErrDeactivatedDomain + Reactivate 后可正常注册 + 重复 Reactivate 报 ErrUserNotExists）、
|
||||
`TestBanUserAndCleanupRemovesRow`（封禁物理删除且可重新注册）。
|
||||
- **CLI 端到端实测**（临时库 `tamabox-clitest`，用 `NEKOBOX_CONFIG_PATH` 指向临时 ini，跑完已 DROP + 删除产物）：
|
||||
- `restore --email clitest@example.com --yes` → deleted_at 变 NULL ✅；重复恢复 → 正确拒绝「未被停用，无需恢复」✅
|
||||
- `restore --password newpass12345` → 密码重哈希 + password_version=1 ✅；密码过短/邮箱不存在 → 明确报错 ✅
|
||||
- `ban --domain banme --yes` → users 与 questions 计数归零（物理删除）✅
|
||||
- ⚠️ `conf.Init` 还需要 `server.salt` / `server.xsrf_key` / `app.external_url` 非空，配置路径可用
|
||||
`NEKOBOX_CONFIG_PATH` 覆盖 —— 这是本地跑 CLI 冒烟的关键（仓库里只有 `conf/app.sample.ini`）。
|
||||
- 测试环境 `devcheck-e2e.py` 的核心回归项已改为断言「重注册被明确拒绝并出现『已停用』提示、且不是 500 兜底」；
|
||||
在**未重新部署的旧构建**上会 FAIL 并打印「サーバー内部エラー」，正是需要重新部署的信号。
|
||||
|
||||
|
||||
|
||||
@@ -107,6 +107,24 @@
|
||||
- **启动期「历史数据归一」的既有惯例**：在 `db.Init` 的 `AutoMigrate` 之后追加幂等函数
|
||||
（`backfillFeatureControls` / `reconcileLegacyChatEnabled` / `normalizeChatQuota` / `normalizeHarassmentSetting`），
|
||||
失败仅告警、不阻断启动。新增此类归一照此模式即可。
|
||||
- ⚠️ **事务里复用同一个 `tx` 句柄会串条件**：事务句柄的 `clone == 0`，`tx.Where(A)...; tx.Where(B)...`
|
||||
会把 A 的条件累加到 B 的语句上（实测生成 `DELETE FROM follow_ups WHERE <follow_ups 条件> AND <messages 条件>`
|
||||
→ `字段 conversation_id 不存在 (42703)`）。**每条语句都必须重新取句柄**：`tx.WithContext(ctx).<链式调用>`。
|
||||
（`db.WithContext(ctx)` / `.Session(...)` 返回 clone==1 的新句柄，链式调用才会 clone。）
|
||||
- ⚠️ **软删除 + 唯一索引 = 唯一槽位被永久占用**。User 的 `email`/`domain`、`Conversation.token`、
|
||||
`VoteSubmission` 的复合唯一索引都**不含 deleted_at**，而 gorm 的查重查询默认带 `deleted_at IS NULL` →
|
||||
「查重放行、INSERT 被索引拦下」，表现为 500。**处置分两种语义，别混**：
|
||||
- **停用（可恢复）**：`users.Deactivate` = `purgeUserContent()` 物理删内容 + **软删除用户行**（身份占位）。
|
||||
邮箱/域名继续被占用是有意为之（防他人抢占身份），注册侧必须用 `Unscoped` 识别并给出
|
||||
`ErrDeactivatedEmail` / `ErrDeactivatedDomain`（见 `validate` / `fieldTaken`），**不能**当成普通重复邮箱。
|
||||
站长用 `TamaBox restore --email|--domain [--password] --yes` 恢复。
|
||||
- **封禁（不可恢复）**：`users.BanUserAndCleanup` = `purgeUserContent()` + **物理删除用户行**，邮箱彻底释放。
|
||||
- 级联内容删除一律 `Unscoped()` 物理删除；`voteSubmissions.DeleteByVoteID` 同理（`vote_submissions.go:234`）。
|
||||
**新增「删除后要能重建」的路径时务必 Unscoped；新增「删除后仍占位」的路径时务必让注册侧能识别。**
|
||||
- 唯一键冲突兜底：`isDuplicateKeyError(err)`（`vote_submissions.go`，MySQL 1062 / PG 23505）。
|
||||
注册不需要额外兜底 —— `validate` 已覆盖活跃 + 已停用两种占用。
|
||||
- ⚠️ **`cmd/tamabox.go` 的 `app.Commands` 容易漏注册**：`internal/cmd/ban.go` 曾写好但没注册，
|
||||
`TamaBox ban` 实际不可达。新增 CLI 命令记得同时改这里。
|
||||
|
||||
## 文件工具陷阱（重要）
|
||||
|
||||
@@ -138,3 +156,27 @@
|
||||
- **git 仓库已损坏**（`.git/refs` 缺失、index 截断、对象库近乎空），用户明确要求「不要动 git」。
|
||||
备份/回滚一律用 tar.gz（排除 `.git`、`.workbuddy`），放在项目同级目录：
|
||||
`C:/OtherFiles/Github/TamaBox-v4-mainline-<描述>-<日期>.tar.gz`。
|
||||
|
||||
## 测试环境（box-dev-api.337845818.best）
|
||||
|
||||
- **该域名跑的就是本工作区的构建**（2026-09-15 实测：本地新建的模板/路由/文案能在线访问到），
|
||||
但部署有延迟 —— 需重新构建/重启才会生效。**改完代码要提醒用户重新部署**，不要假定已生效。
|
||||
- 站点默认语言是 **ja**（`shared.App.Lang()`），匿名页断言别写中文文案，用语言无关标记（如 `ratio: 3`）。
|
||||
- 验证码是**数学题**（`conf.Recaptcha.CaptchaType == "math"`），可用脚本自动求解：
|
||||
`GET /api/captcha/generate` 取 `{data:{id,question}}`，把 `a op b =` 算出来，提交 `g-recaptcha-response = "<id>:<答案>"`；
|
||||
表单还需页面里的 `_csrf`（`name="_csrf"` 隐藏域）。
|
||||
- 可复用的端到端巡检脚本：`dev/devcheck-e2e.py`（注册→登录→提问→回答→投票→停用→同邮箱重注册）。
|
||||
- 表单字段名易错：提问是 `content` + `g-recaptcha-response`；回答是 `answer`（不是 content）。
|
||||
`GET /user/votes` **故意** 302 到 `/user/questions#votes`，不是 bug。
|
||||
匿名无邮箱提问成功后**直接 200 渲染提问成功页**（不重定向），也不是 bug。
|
||||
|
||||
## 管理 CLI（`TamaBox <cmd>`）
|
||||
|
||||
- 注册在 `cmd/tamabox.go` 的 `app.Commands`。现有：`web` / `censor` / `uid` / `ban` / `restore`。
|
||||
- `ban --email|--domain [--yes]` → 物理删除用户 + 内容（不可恢复，邮箱释放）。
|
||||
- `restore --email|--domain [--password <新密码>] [--yes]` → 恢复已停用账号（清 deleted_at）。
|
||||
`--password` 必须在恢复之后执行（`UpdatePassword` 走普通作用域，软删除状态下找不到用户）。
|
||||
- 本地冒烟：仓库里**只有 `conf/app.sample.ini`**（真 `app.ini` 不在版本库），
|
||||
用 `NEKOBOX_CONFIG_PATH=<你的 ini>` 指定配置即可；`conf.Init` 强制要求
|
||||
`app.external_url`、`server.salt`、`server.xsrf_key` 三者非空。
|
||||
跑 `TamaBox <cmd>` 会自动 `AutoMigrate`，可直接指向一个临时库做端到端验证（用完 DROP）。
|
||||
|
||||
Reference in New Issue
Block a user