multi-platform-media-manage/docs/baijiahao-test-checklist.md

百家号后台跳转功能测试清单

测试前准备

• 重启应用（确保所有代码修改生效）
• 打开浏览器开发者工具（F12）
• 打开终端查看 Electron 日志

测试步骤

1. 点击"后台"按钮

• 在账号管理页面找到百家号账号
• 点击"后台"按钮

2. 检查前端日志（浏览器控制台）

应该看到以下日志：

• [账号管理] 获取到 Cookie 数据，准备打开后台
• [BrowserTab] 检测到预设 Cookie，先设置再加载页面
• [BrowserTab] 成功解析 JSON 格式的 Cookie
• [BrowserTab] 设置 Cookie, platform=baijiahao, cookieUrl=https://www.baidu.com ⭐ 关键
• [BrowserTab] 百家号平台，等待 Cookie 生效... ⭐ 关键
• [BrowserTab] 准备设置 X 个 Cookies

3. 检查 Electron 日志（终端）

应该看到以下日志：

• [Main] 设置 webview cookies, partition=persist:browser-xxx, count=X
• [Main] 成功设置关键 Cookie: BDUSS, domain: .baidu.com ⭐ 关键
• [Main] 成功设置关键 Cookie: STOKEN, domain: .baidu.com ⭐ 关键
• [Main] 成功设置 X/X 个 cookies
• [Main] 验证：当前 session 中有 X 个百度 Cookie ⭐ 关键

4. 验证页面加载

• 页面应该加载 https://baijiahao.baidu.com/builder/rc/home
• 页面应该直接显示后台首页，而不是登录页面
• 页面应该显示账号信息（头像、昵称等）

如果测试失败

场景 1：仍然跳转到登录页面

检查项：

1. [ ] 日志中是否显示 cookieUrl=https://www.baidu.com？

   • 如果不是，说明代码没有正确更新，需要重新编译
     

2. [ ] 日志中是否显示 成功设置关键 Cookie: BDUSS？

   • 如果没有，说明 Cookie 中缺少 BDUSS，需要重新登录
     

3. [ ] 日志中是否显示 验证：当前 session 中有 X 个百度 Cookie？

   • 如果 X = 0，说明 Cookie 设置失败
   • 如果 X > 0，说明 Cookie 设置成功，但可能已过期

解决方法：

• 重新登录该账号
• 检查 Cookie 是否过期
• 查看详细的错误日志

场景 2：提示"账号 Cookie 数据为空"

原因：

• 账号从未登录过
• Cookie 数据在数据库中丢失

解决方法：

• 重新登录该账号

场景 3：提示"账号登录已过期"

原因：

• Cookie 已过期（通常是 30 天后）

解决方法：

• 重新登录该账号

场景 4：日志中显示 "Cookie xxx 已过期，跳过"

原因：

• Cookie 的过期时间已经到了

解决方法：

• 重新登录该账号

高级调试

1. 检查 webview 中的 Cookie

1. 在 webview 中右键 -> 检查元素
2. 打开 Application 标签
3. 展开 Cookies
4. 查看 https://baijiahao.baidu.com 下的 Cookie
5. 确认是否有 .baidu.com 域名的 Cookie
6. 确认是否包含 BDUSS 和 STOKEN

2. 手动测试 Cookie

在 webview 的控制台中执行：

// 查看所有 Cookie
document.cookie

// 查看特定 Cookie
document.cookie.split(';').find(c => c.includes('BDUSS'))

3. 检查网络请求

1. 打开 Network 标签
2. 刷新页面
3. 查看第一个请求（通常是 HTML 文档）
4. 查看 Request Headers
5. 确认是否包含 Cookie 头
6. 确认 Cookie 中是否包含 BDUSS

成功标准

✅ 测试通过的标志：

1. 日志中显示 cookieUrl=https://www.baidu.com
2. 日志中显示 成功设置关键 Cookie: BDUSS
3. 日志中显示 验证：当前 session 中有 X 个百度 Cookie（X > 0）
4. 页面直接显示后台首页，不跳转到登录页面
5. 页面显示账号信息

报告问题

如果测试仍然失败，请提供以下信息：

1. 完整的前端日志（从点击"后台"按钮开始）
2. 完整的 Electron 日志（从点击"后台"按钮开始）
3. webview 中的 Cookie 截图（Application -> Cookies）
4. 网络请求截图（Network 标签，第一个请求的 Headers）
5. 页面截图（显示当前页面状态）

注意事项

• 每次修改代码后，必须重启应用
• 如果使用了热重载，可能需要完全关闭应用后重新启动
• Cookie 有 30 天的有效期，过期后需要重新登录
• 不同的百家号账号可能有不同的 Cookie 结构