更新

2026-03-27 18:06:12 +08:00
parent 9160c36735
commit 099bc1dd22
645 changed files with 276473 additions and 957 deletions
@@ -0,0 +1,277 @@
+# 首次登录修改密码 - 调试指南
+
+## 如何验证功能是否正常工作
+
+### 1. 检查数据库
+
+```sql
+-- 查看管理员的 is_paw 状态
+SELECT id, account, name, is_paw FROM la_admin WHERE id = 1;
+```
+
+确认 `is_paw` 字段存在且值为 0。
+
+### 2. 检查后端 API
+
+#### 2.1 登录接口
+
+打开浏览器开发者工具（F12），切换到 Network 标签。
+
+登录后查看 `/adminapi/login/account` 接口的响应：
+
+```json
+{
+    "code": 1,
+    "msg": "success",
+    "data": {
+        "name": "管理员",
+        "avatar": "...",
+        "role_name": "超级管理员",
+        "token": "...",
+        "is_paw": 0  // ← 确认这个字段存在且为 0
+    }
+}
+```
+
+#### 2.2 获取用户信息接口
+
+刷新页面后，查看 `/adminapi/auth.admin/mySelf` 接口的响应：
+
+```json
+{
+    "code": 1,
+    "msg": "success",
+    "data": {
+        "user": {
+            "id": 1,
+            "account": "admin",
+            "name": "管理员",
+            "is_paw": 0,  // ← 确认这个字段存在且为 0
+            // ... 其他字段
+        },
+        "menu": [...],
+        "permissions": [...]
+    }
+}
+```
+
+### 3. 检查前端状态
+
+在浏览器控制台（Console）中输入：
+
+```javascript
+// 查看 userStore 的状态
+const userStore = window.$nuxt?.$store?.state?.user || 
+                  JSON.parse(localStorage.getItem('pinia-user') || '{}')
+console.log('isPaw:', userStore.isPaw)
+console.log('userInfo:', userStore.userInfo)
+```
+
+或者在 Vue DevTools 中查看 Pinia store 的状态。
+
+### 4. 检查路由守卫
+
+在 `admin/src/permission.ts` 文件中添加调试日志：
+
+```typescript
+router.beforeEach(async (to, from, next) => {
+    const userStore = useUserStore()
+    
+    console.log('=== 路由守卫 ===')
+    console.log('目标路径:', to.path)
+    console.log('isPaw:', userStore.isPaw)
+    console.log('hasUserInfo:', Object.keys(userStore.userInfo).length !== 0)
+    
+    // ... 其他代码
+})
+```
+
+刷新页面，在控制台查看输出。
+
+### 5. 完整测试流程
+
+#### 步骤 1：设置测试账号
+
+```sql
+UPDATE la_admin SET is_paw = 0 WHERE id = 1;
+```
+
+#### 步骤 2：清除浏览器缓存
+
+- 清除 localStorage
+- 清除 sessionStorage
+- 清除 Cookies
+- 或者使用无痕模式
+
+#### 步骤 3：登录
+
+1. 打开浏览器开发者工具（F12）
+2. 切换到 Network 标签
+3. 登录系统
+4. 查看 `/adminapi/login/account` 接口响应，确认 `is_paw: 0`
+5. 观察是否跳转到 `/change-password`
+
+#### 步骤 4：测试 URL 绕过
+
+1. 在地址栏输入 `/workbench/index`
+2. 按回车
+3. 观察是否被拦截并跳转回 `/change-password`
+
+#### 步骤 5：测试刷新
+
+1. 在修改密码页面按 F5 刷新
+2. 查看 Network 标签，确认调用了 `/adminapi/auth.admin/mySelf` 接口
+3. 查看接口响应，确认 `is_paw: 0`
+4. 观察是否仍然停留在 `/change-password`
+
+#### 步骤 6：修改密码
+
+1. 输入新密码（至少 6 位）
+2. 点击"确认修改"
+3. 观察是否提示"密码修改成功，请重新登录"
+4. 观察是否跳转到登录页
+
+#### 步骤 7：验证数据库
+
+```sql
+SELECT id, account, is_paw FROM la_admin WHERE id = 1;
+-- 应该显示 is_paw = 1
+```
+
+#### 步骤 8：使用新密码登录
+
+1. 使用新密码登录
+2. 观察是否直接进入系统（不跳转到修改密码页面）
+
+## 常见问题排查
+
+### 问题：登录后没有跳转到修改密码页面
+
+**排查步骤：**
+
+1. 检查登录接口响应是否包含 `is_paw` 字段
+   ```javascript
+   // 在 Network 标签查看 /adminapi/login/account 响应
+   ```
+
+2. 检查前端是否保存了 `isPaw` 状态
+   ```javascript
+   // 在 Console 输入
+   console.log(useUserStore().isPaw)
+   ```
+
+3. 检查登录页面代码
+   ```typescript
+   // admin/src/views/account/login.vue
+   const result: any = await userStore.login(formData)
+   if (result.is_paw === 0) {
+       router.push('/change-password')
+   }
+   ```
+
+### 问题：刷新后进入系统
+
+**排查步骤：**
+
+1. 检查 `getUserInfo` 接口是否返回 `is_paw`
+   ```javascript
+   // 在 Network 标签查看 /adminapi/auth.admin/mySelf 响应
+   // 确认 data.user.is_paw 存在
+   ```
+
+2. 检查后端代码
+   ```php
+   // server/app/adminapi/logic/auth/AdminLogic.php
+   // detail() 方法的 field 数组中是否包含 'is_paw'
+   ```
+
+3. 检查前端是否更新状态
+   ```typescript
+   // admin/src/stores/modules/user.ts
+   getUserInfo() {
+       return new Promise((resolve, reject) => {
+           getUserInfo().then((data) => {
+               this.isPaw = data.user.is_paw ?? 1  // 确认这行存在
+           })
+       })
+   }
+   ```
+
+4. 检查路由守卫逻辑
+   ```typescript
+   // admin/src/permission.ts
+   // 确认在 getUserInfo() 之后检查 isPaw
+   await userStore.getUserInfo()
+   if (userStore.isPaw === 0) {
+       next({ path: changePasswordPath })
+       return
+   }
+   ```
+
+### 问题：可以通过 URL 绕过
+
+**排查步骤：**
+
+1. 检查路由守卫是否正确配置
+   ```typescript
+   // admin/src/permission.ts
+   // 确认路由守卫在所有路由跳转时都会执行
+   ```
+
+2. 在路由守卫中添加日志
+   ```typescript
+   router.beforeEach(async (to, from, next) => {
+       console.log('路由守卫执行:', to.path, 'isPaw:', userStore.isPaw)
+       // ...
+   })
+   ```
+
+3. 检查是否有其他路由配置覆盖了守卫
+
+## 调试技巧
+
+### 1. 使用 Vue DevTools
+
+安装 Vue DevTools 浏览器插件，可以实时查看：
+- Pinia store 状态
+- 路由信息
+- 组件状态
+
+### 2. 添加断点
+
+在关键位置添加 `debugger` 语句：
+
+```typescript
+// admin/src/permission.ts
+router.beforeEach(async (to, from, next) => {
+    debugger  // 浏览器会在这里暂停
+    const userStore = useUserStore()
+    // ...
+})
+```
+
+### 3. 查看完整的请求响应
+
+在 Network 标签中：
+- 点击请求
+- 查看 Response 标签
+- 确认返回的数据结构
+
+### 4. 清除缓存测试
+
+每次测试前清除缓存，确保测试环境干净：
+
+```javascript
+// 在 Console 中执行
+localStorage.clear()
+sessionStorage.clear()
+location.reload()
+```
+
+## 成功标准
+
+✅ 登录后自动跳转到修改密码页面
+✅ 无法通过输入 URL 绕过
+✅ 刷新后仍然在修改密码页面
+✅ 修改密码后 `is_paw` 更新为 1
+✅ 使用新密码登录后正常进入系统