template-10550/首页分享链接测试步骤.md

首页分享链接白屏问题测试

✅ 编译成功

项目已成功编译，没有TypeScript错误。现在可以开始测试。

🧪 立即测试步骤

1. 启动开发环境

npm run dev:weapp

2. 测试首页分享功能

步骤A：创建分享链接

1. 在微信开发者工具中打开小程序
2. 进入首页（pages/index/index）
3. 点击右上角的分享按钮
4. 选择"分享给朋友"
5. 复制生成的分享链接

步骤B：从分享链接进入

1. 关闭当前小程序
2. 从分享链接重新进入
3. 观察加载过程

3. 预期结果对比

❌ 修复前（问题状态）

• 页面显示"加载中..."
• 长时间白屏
• 无法正常显示内容
• 用户无法操作

✅ 修复后（正常状态）

• 页面正常加载
• 邀请关系在后台处理（不阻塞页面）
• 即使邀请处理失败，页面仍正常显示
• 控制台有相关日志输出

4. 关键日志监控

在微信开发者工具的控制台中，应该看到：

=== 小程序启动参数处理开始 ===
完整启动参数: {...}
检测到待处理的邀请关系
使用用户ID处理邀请关系: [用户ID]
首页邀请关系处理成功 (或失败但不影响页面)
=== 小程序启动参数处理结束 ===

5. 特殊场景测试

场景1：网络异常测试

1. 在开发者工具中设置网络为"离线"
2. 从首页分享链接进入
3. 预期：页面应该能显示基本内容，邀请处理超时后不影响页面

场景2：邀请API失败测试

1. 暂时修改邀请API地址为无效地址
2. 从分享链接进入
3. 预期：邀请处理失败，但页面正常显示

6. 性能验证

加载时间测试

• 目标：首页应在3秒内完成基本加载
• 方法：在控制台查看加载时间日志
• 标准：即使邀请处理失败，页面也应快速显示

7. 问题排查

如果仍有问题，请检查：

检查1：清理缓存

# 在微信开发者工具中
# 点击"清缓存" -> "清除全部缓存"
# 然后重新编译
npm run build:weapp

检查2：查看具体错误

在控制台中执行：

// 查看邀请参数
console.log('邀请参数:', Taro.getStorageSync('invite_params'))

// 查看用户登录状态
console.log('用户ID:', Taro.getStorageSync('UserId'))
console.log('访问令牌:', Taro.getStorageSync('access_token'))

// 手动测试邀请处理
import { checkAndHandleInviteRelation } from '@/utils/invite'
checkAndHandleInviteRelation().then(result => {
  console.log('手动处理结果:', result)
}).catch(error => {
  console.log('手动处理错误:', error)
})

检查3：API状态

在网络面板中查看：

• /api/wx-login/loginByOpenId 请求状态
• /shop/shop-dealer-referee 请求状态
• 是否有请求超时或失败

8. 成功验证清单

• 基础功能

  • 首页分享链接可以正常打开
  • 页面内容正常显示
  • 不出现长时间白屏

• 邀请功能

  • 邀请参数正常解析
  • 邀请关系处理不阻塞页面
  • 处理失败时有合适的日志

• 错误处理

  • 网络异常时页面仍可访问
  • 超时保护机制正常工作
  • 错误日志清晰明确

• 性能表现

  • 页面加载时间合理
  • 用户体验流畅
  • 内存使用正常

🎯 测试结论

如果以上测试都通过，说明首页分享链接白屏问题已经解决。

如果仍有问题，请提供：

1. 具体的错误信息
2. 控制台完整日志
3. 网络请求状态
4. 复现的具体步骤

这样我可以进一步诊断和修复。