login_debug_guide.md

# 小红书登录状态调试指南

## 问题现象
登录验证失败，提示"未找到登录状态，请先登录"

## 调试步骤

### 1. 检查服务是否正常启动
```bash
# 启动服务
python main.py

# 在另一个终端访问调试接口
curl http://localhost:18085/api/debug/browser
```

**预期输出：**
```json
{
  "browser_exists": true,
  "contexts_count": 0,
  "contexts": [],
  "data_dir": "data",
  "auth_file_exists": false,
  "storage_file_exists": false
}
```

### 2. 检查浏览器状态
查看控制台输出，应该看到：
```
[INFO] 浏览器初始化完成
[DEBUG] === 检查浏览器状态 ===
[DEBUG] 浏览器实例存在: true
```

### 3. 打开登录页面
1. 访问：http://localhost:18085
2. 点击"打开登录页"按钮
3. 在新窗口中扫码登录小红书
4. 登录成功后不要关闭窗口

### 4. 测试登录验证
返回页面，点击"验证登录"按钮，查看控制台输出。

**预期成功输出：**
```
[DEBUG] 开始验证登录状态...
[DEBUG] 尝试保存 storage_state 到: data/storage_state.json
[DEBUG] ✓ 成功保存 storage_state
[DEBUG] storage_state 文件大小: 2456 bytes
[DEBUG] 使用 storage_state 验证登录...
[DEBUG] ✓ 登录验证成功
```

### 5. 手动验证API
使用curl测试各个接口：
```bash
# 检查登录状态
curl http://localhost:18085/api/check-login-status

# 验证登录
curl -X POST http://localhost:18085/api/login/verify

# 查看调试信息
curl http://localhost:18085/api/debug/browser
```

## 常见问题及解决方案

### 问题1：浏览器初始化失败
**现象：** `browser_exists: false`

**原因：** Playwright浏览器未安装
**解决：**
```bash
playwright install chromium
```

### 问题2：Context不存在
**现象：** `contexts_count: 0`

**原因：** 浏览器Context未创建
**解决：** 重启服务，确保浏览器在应用启动时初始化

### 问题3：保存storage_state失败
**现象：** 保存storage_state时异常

**原因：** 权限问题或目录不存在
**解决：**
```bash
mkdir -p data
chmod 755 data
```

### 问题4：验证失败但已登录
**现象：** 已经扫码登录，但验证失败

**原因：**
1. 页面加载不完整
2. 风控拦截
3. Cookie变化

**解决：**
1. 等待页面完全加载后再验证
2. 尝试重新登录
3. 检查控制台详细错误信息

## 详细调试流程

### 1. 完整日志查看
```bash
# 启动服务时显示详细日志
python main.py  # 查看所有输出

# 或使用日志级别
uvicorn app.web:app --log-level debug
```

### 2. 文件检查
检查以下文件是否存在：
- `data/storage_state.json` - 浏览器状态文件
- `data/auth_state.json` - 认证状态文件
- `data/logs.json` - 操作日志

### 3. 手动测试storage_state
```python
# 手动测试storage_state保存
from playwright.async_api import async_playwright

async def test_storage():
    async with async_playwright() as p:
        browser = await p.chromium.launch()
        context = await browser.new_context()
        page = await context.new_page()

        # 访问小红书
        await page.goto("https://www.xiaohongshu.com")
        await asyncio.sleep(2)

        # 保存storage_state
        await context.storage_state(path="test_storage.json")
        await browser.close()

# 运行测试
asyncio.run(test_storage())
```

### 4. Cookie分析
如果保存了storage_state文件，可以查看其中的cookies部分：
```json
{
  "cookies": [
    {
      "name": "a1",
      "value": "...",
      "domain": ".xiaohongshu.com",
      "path": "/",
      "expires": -1,
      "httpOnly": false,
      "secure": true,
      "sameSite": "Lax"
    }
  ]
}
```

## 进阶调试

### 1. 使用浏览器开发者工具
1. 在登录页面打开开发者工具（F12）
2. 切换到Application/Storage标签
3. 查看Cookies和Local Storage
4. 确认登录相关的cookie是否存在

### 2. 网络请求分析
1. 在开发者工具的Network标签中
2. 查看对`xiaohongshu.com`的请求
3. 确认请求头中是否包含正确的Cookie

### 3. 手动验证登录状态
```javascript
// 在浏览器控制台运行
// 检查是否有登录相关的cookie
document.cookie.split(';').forEach(cookie => {
  const [name, value] = cookie.trim().split('=');
  if (name.includes('session') || name.includes('token') || name.includes('auth')) {
    console.log(`${name}: ${value}`);
  }
});

// 检查localStorage
console.log('localStorage:', Object.keys(localStorage));

// 检查是否被重定向到登录页
if (window.location.pathname.includes('login')) {
  console.log('被重定向到登录页');
}
```

## 联系技术支持
如果以上步骤都无法解决问题，请提供以下信息：
1. 完整的控制台输出
2. 三个文件的内容（如果存在）：
   - `data/storage_state.json`
   - `data/auth_state.json`
   - `data/logs.json`
3. 浏览器类型和版本
4. 操作系统信息