跳到主要内容

第七部分：常见问题

本章节收集了用户在使用 InsightHub 过程中最常遇到的问题和解决方案。

登录与认证​

Q1: 登录时提示"重定向 URI 不匹配"怎么办？​

问题描述：点击登录按钮后，浏览器显示 OAuth 错误，提示重定向 URI 不匹配。

可能原因：

  • Google Cloud Console 中配置的 OAuth 客户端 ID 没有包含当前访问的域名
  • 本地开发环境使用了不同的端口号

解决方案：

  1. 检查当前访问的 URL（如 http://localhost:5173 或生产环境域名）
  2. 访问 Google Cloud Console > API 和服务 > 凭据
  3. 找到对应的 OAuth 客户端 ID，点击编辑
  4. 在 已获授权的 JavaScript 来源 中添加当前 URL（不包含路径）
  5. 在 已获授权的重定向 URI 中添加完整的回调 URL
  6. 保存更改（可能需要几分钟生效）

详细文档：参考 Google Cloud 配置指南

Q2: 登录后无法访问功能页面？​

问题描述：登录成功，但点击功能菜单没有反应或显示错误。

可能原因：

  • 浏览器缓存问题
  • 权限配置问题
  • 后端服务未启动（本地开发环境）

解决方案：

  1. 清除浏览器缓存和 Cookie
  2. 检查浏览器控制台是否有错误信息
  3. 如果是本地开发，确认后端服务已启动（http://localhost:8080）
  4. 尝试使用无痕模式重新登录

数据分析​

Q3: 上传文件后没有反应？​

问题描述：点击上传文件后，页面没有显示上传进度或文件信息。

可能原因：

  • 文件格式不支持
  • 文件过大
  • 浏览器兼容性问题
  • 网络问题

解决方案：

  1. 检查文件格式：
    • 市场机会分析：支持 .xlsx 格式
    • 人群信号分析：支持 .xlsx 或 .csv 格式
    • 受众画像幻灯片：支持 .xlsx 格式
  2. 检查文件大小：建议单个文件不超过 10MB
  3. 检查浏览器控制台：查看是否有错误信息
  4. 尝试其他浏览器：推荐使用 Chrome 或 Edge 最新版本
  5. 检查网络连接：确保网络连接正常

详细文档：参考各功能的 用户使用手册

Q4: 分析时间过长怎么办？​

问题描述：点击"开始分析"后，进度条长时间没有更新，或分析时间超过预期。

可能原因：

  • 数据量过大
  • AI API 响应慢
  • 网络问题
  • 系统负载高

解决方案：

  1. 减少数据量：
    • 市场机会分析：减少分析的国家数量（建议 5-10 个国家）
    • 人群信号分析：减少查询词数量
    • 受众画像幻灯片：减少 Persona 数量
  2. 检查网络连接：确保网络连接稳定，VPN 已正确配置
  3. 等待时间：
    • 市场机会分析：通常 1-3 分钟
    • 人群信号分析：通常 2-5 分钟
    • 受众画像幻灯片：通常 3-8 分钟（取决于 Persona 数量）
  4. 如果超过 10 分钟：
    • 刷新页面重试
    • 检查浏览器控制台错误信息
    • 联系技术支持

Q5: 分析结果不准确或不符合预期？​

问题描述：分析完成，但结果与预期不符，或某些数据没有正确识别。

可能原因：

  • 数据格式不正确
  • 数据质量问题
  • AI 理解偏差

解决方案：

  1. 检查数据格式：
    • 确认所有必需列都存在
    • 检查列名是否正确（支持中英文）
    • 检查数据类型是否正确（数值、文本、布尔值）
  2. 检查数据质量：
    • 确认没有空值或异常值
    • 检查数值范围是否合理
    • 确认分类字段的值符合预期
  3. 查看详细文档：参考各功能的 用户使用手册，了解数据格式要求
  4. 提供反馈：如果确认数据无误，可以通过反馈功能报告问题

导出与下载​

Q6: 导出到 Google Drive 失败？​

问题描述：点击"导出到 Google Drive"后，显示错误或没有创建文件。

可能原因：

  • Google Drive API 权限问题
  • 存储空间不足
  • 网络问题

解决方案：

  1. 检查权限：
    • 确认已授权应用访问 Google Drive
    • 在 Google 账户设置中检查应用权限
  2. 检查存储空间：确认 Google Drive 有足够的存储空间
  3. 重试操作：网络问题可能导致失败，可以重试
  4. 使用其他导出方式：
    • 导出为 PPTX 文件下载到本地
    • 导出为 ZIP 文件下载到本地

详细文档：参考各功能的 用户使用手册

Q7: 下载的文件无法打开？​

问题描述：下载 PPTX 或 ZIP 文件后，无法打开或文件损坏。

可能原因：

  • 下载不完整
  • 文件格式问题
  • 解压软件问题

解决方案：

  1. 重新下载：删除旧文件，重新导出并下载
  2. 检查文件大小：确认文件大小正常（不为 0KB）
  3. 检查文件格式：
    • PPTX 文件需要使用 Microsoft PowerPoint 或兼容软件打开
    • ZIP 文件需要使用解压软件（如 WinRAR、7-Zip）解压
  4. 尝试其他浏览器：某些浏览器可能对下载文件处理不当

性能与错误​

Q8: 页面加载缓慢？​

问题描述：打开页面或切换功能时，加载时间很长。

可能原因：

  • 网络问题
  • 浏览器缓存问题
  • 系统负载高

解决方案：

  1. 检查网络连接：确保网络连接正常，VPN 已正确配置
  2. 清除浏览器缓存：
    • Chrome/Edge: Ctrl+Shift+Delete (Windows) 或 Cmd+Shift+Delete (Mac)
    • 选择"缓存的图片和文件"，清除缓存
  3. 使用最新浏览器：确保使用最新版本的浏览器
  4. 检查系统资源：关闭其他占用资源的标签页或应用

Q9: 页面显示错误信息？​

问题描述：页面显示错误提示，如"网络错误"、"服务不可用"等。

可能原因：

  • 后端服务未启动（本地开发）
  • API 服务异常
  • 网络问题

解决方案：

  1. 检查后端服务（本地开发）：
    • 确认后端服务已启动（http://localhost:8080）
    • 检查后端日志是否有错误
  2. 检查网络连接：确保网络连接正常
  3. 查看错误详情：
    • 打开浏览器开发者工具（F12）
    • 查看 Console 和 Network 标签页
    • 记录错误信息，联系技术支持
  4. 重试操作：如果是临时网络问题，可以刷新页面重试

Q10: 浏览器控制台显示错误？​

问题描述：打开浏览器开发者工具，Console 中显示红色错误信息。

解决方案：

  1. 记录错误信息：复制完整的错误信息
  2. 检查错误类型：
    • 网络错误：检查网络连接和后端服务
    • 权限错误：检查登录状态和 API 权限
    • 代码错误：联系技术支持
  3. 提供上下文：
    • 记录操作步骤
    • 记录错误发生的时间
    • 提供浏览器和操作系统信息
  4. 联系技术支持：将错误信息提供给技术支持团队

数据格式​

Q11: 如何准备市场机会分析的数据？​

数据要求：

  • 文件格式：.xlsx
  • 必需列：品类名称、国家名称、市场竞争度（CPC）、Clicks、Clicks (PoP)、市场需求中位数、市场竞争中位数、市场竞争增速中位数、是否为高竞争、是否为高需求、属于哪个市场

详细说明：参考 市场机会分析功能深度指南

Q12: 如何准备人群信号分析的数据？​

数据要求：

  • 文件格式：.xlsx 或 .csv
  • 必需列：Query（搜索词）、Affinity Search、In-Market Search 等维度数据

详细说明：参考 人群信号分析功能深度指南

Q13: 如何准备受众画像幻灯片的数据？​

数据要求：

  • 文件格式：.xlsx
  • 必需列：Persona 相关信息（姓名、年龄、兴趣、行为等）

详细说明：参考 受众画像幻灯片功能深度指南

其他问题​

Q14: 如何理解分析结果中的市场类型？​

市场类型说明：

  • 机会市场：高需求、低竞争，是最佳进入机会
  • 挑战市场：高需求、高竞争，需要充分准备
  • 潜力市场：低需求、低竞争，需要培育
  • 蓝海市场：低需求、高竞争，需要谨慎评估

详细说明：参考 市场机会分析功能深度指南

Q15: 如何联系技术支持？​

联系方式：

  1. 通过系统内的反馈功能提交问题
  2. 在团队沟通渠道（如 Slack、邮件）中提问
  3. 在 GitHub Issue 中创建问题（如果是开发者）

提供信息：

  • 问题描述
  • 操作步骤
  • 错误信息（如有）
  • 浏览器和操作系统信息
  • 截图（如有）

需要更多帮助？​

如果以上问题无法解决你的问题：

  1. 查阅 快速开始 指南
  2. 查看详细的 用户使用手册
  3. 参考 开发指南 中的故障排查章节
  4. 联系技术支持团队