Cyrene/docs/debug/2026-05-20-round2-auth-integration.md

持续性调试第2轮: 用户认证流程端到端 + 服务集成测试

日期: 2026-05-20 13:58 CST (UTC+8)
基于第1轮 REG1 修复 (commit 9dd1582): users 表缺失已修复
测试环境: Gateway 编译后后台运行, PostgreSQL 通过 SSH 隧道连接

---

1. 环境准备

检查项	状态	详情
SSH 隧道 (PostgreSQL 5432)	✅	ssh 进程监听 127.0.0.1:5432
旧 gateway 进程	✅ 已停止	PID 12619 已被 kill
编译新 gateway	✅ 成功	go build -o ./cmd/gateway ./cmd/main.go
Gateway 后台启动	✅	PID 19265, 端口 8080

---

2. users 表 + 种子管理员验证

2.1 启动日志 (关键行)

2026/05/20 13:55:44 ✅ Users 表已就绪
2026/05/20 13:55:45 🔧 未找到管理员用户，创建默认 admin (username: admin, password: admin123)...
2026/05/20 13:55:45 ✅ 默认管理员用户已创建 (username: admin, password: admin123)

2.2 PostgreSQL 查询确认

SELECT id, username, is_admin, created_at FROM users ORDER BY id;

id	username	is_admin	created_at
1	yeij0942	t	2026-05-20 05:55:45+00
2	testuser1	f	2026-05-20 05:57:13+00

2.3 发现的问题

🟡 ISSUE-1: 种子日志文案与实际用户名不一致

• main.go:66 日志写 "username: admin, password: admin123"
• 实际 cfg.AdminUsername 来自 .env = yeij0942
• main.go:68 种子密码硬编码 admin123，与 .env 中 ADMIN_PASSWORD=Jiang1143218570 不一致
• 影响: 日志误导，但功能正常。种子用户名为 yeij0942，密码为 admin123
• 根因: 日志文案使用字面量 "admin" 而代码使用 cfg.AdminUsername

🟡 ISSUE-2: 种子密码硬编码

• main.go:68 defaultAdminPassword := "admin123" 硬编码
• .env 中 ADMIN_PASSWORD=Jiang1143218570 未被使用
• 影响: 低。种子只在首次创建时使用，后续登录走 bcrypt 验证

---

3. 用户认证端到端测试

3.1 注册新用户

POST /api/v1/auth/register
{"username":"testuser1","password":"testpass123","email":"test@example.com","nickname":"测试用户","verify_code":"000000"}

结果: ✅ 201 Created

{
    "user_id": "user_testuser1",
    "token": "eyJ...",
    "expires": 1781848633,
    "nickname": "测试用户"
}

验证点:

• ✅ REGISTRATION_ENABLED=true 生效
• ✅ bcrypt 密码哈希写入 users 表
• ✅ JWT token 成功生成 (user_id 前缀为 user_)
• ✅ 验证码 000000 MVP 阶段通过

3.2 新用户登录 (bcrypt 密码验证)

POST /api/v1/auth/login
{"username":"testuser1","password":"testpass123"}

结果: ✅ 200 OK

验证点:

• ✅ verifyUserPassword 从 DB 查询用户 → bcrypt CompareHashAndPassword 成功
• ✅ userID 前缀为 user_ (非 admin)

3.3 管理员登录

POST /api/v1/auth/login
{"username":"yeij0942","password":"admin123"}

结果: ✅ 200 OK

{
    "user_id": "admin_yeij0942",
    "token": "eyJ..."
}

验证点:

• ✅ 种子 admin 通过 bcrypt 验证 (DB 中存在且密码匹配)
• ✅ userID 前缀为 admin_

3.4 Token 访问受保护 API

新用户 token:

GET /api/v1/sessions
Authorization: Bearer <user_testuser1_token>

✅ 200 OK, {"sessions": []} (空列表，符合预期)

管理员 token:

GET /api/v1/sessions
Authorization: Bearer <admin_yeij0942_token>

✅ 200 OK, 返回 2 条已有会话

未认证访问:

GET /api/v1/sessions (无 Authorization header)

✅ 401 Unauthorized, {"error": "未提供认证令牌"} — JWTAuth 中间件正常

错误密码:

POST /api/v1/auth/login
{"username":"testuser1","password":"wrongpass"}

✅ 401 Unauthorized, {"error": "用户名或密码错误"} — bcrypt 比对拒绝

---

4. 多服务集成测试

4.1 Memory Service (8091)

GET /api/v1/memory (via Gateway, with auth)

结果: ✅ 正常转发，返回 1 条已有记忆

{
    "memories": [{
        "id": "8f8af3b7-...",
        "content": "测试记忆内容",
        "user_id": "admin_yeij0942",
        ...
    }],
    "total": 1
}

4.2 Tool-Engine (8092)

结果: ⚠️ 进程在运行 (端口 8092 监听)，但无 /health 端点 (返回 404)，这是预期行为 — tool-engine 未定义该路由。

4.3 当前运行的服务

服务	端口	状态
Gateway	8080	✅ 运行中
Memory Service	8091	✅ 运行中
Tool Engine	8092	✅ 运行中
PostgreSQL	5432	✅ SSH 隧道

---

5. 前端 TypeScript 编译

cd frontend/web && npx tsc --noEmit

结果: ✅ 无错误，编译通过。

---

6. 系统时间

• UTC: 2026-05-20 05:58:47 UTC
• 本地 (CST): 2026-05-20 13:58:47 CST

---

7. 验证点矩阵

#	验证点	结果
1	users 表自动创建	✅
2	种子管理员创建	✅ (用户名 yeij0942, 密码 admin123)
3	普通用户注册	✅
4	新用户登录 (bcrypt)	✅
5	管理员登录	✅
6	JWT token 访问受保护 API	✅
7	未认证拒绝 (401)	✅
8	错误密码拒绝 (401)	✅
9	Memory 服务转发	✅
10	前端 TypeScript 编译	✅

---

8. 发现的问题

ID	严重程度	描述	位置
ISSUE-1	🟡 低	种子日志文案写死 "admin" 但实际用户名为 cfg.AdminUsername	main.go:66
ISSUE-2	🟡 低	种子密码硬编码 admin123，未使用 .env 的 ADMIN_PASSWORD	main.go:68

---

9. 结论

认证流程端到端完全可用。第1轮发现的 REG1 (users 表缺失) 已修复，所有关键路径验证通过：

1. users 表在 gateway 启动时自动创建
2. 种子管理员通过 bcrypt 哈希存入 DB
3. 普通用户可以注册 (bcrypt 哈希存储)
4. 所有用户 (admin + 普通) 可以通过 bcrypt 密码验证登录
5. JWT 中间件正确保护受保护路由
6. Gateway → Memory Service 转发正常
7. 前端编译无错误