🧩 常见问题与排查

本页面汇总了 NextAI 使用过程中常见的问题与解决方案，
帮助你快速定位故障、恢复正常使用。

🔌 网络与连接问题

• 无法连接网络或请求超时

  • 请确保设备已成功联网（Wi-Fi 或蜂窝网络）。
  • 若网络正常但仍提示超时，可能是服务商接口暂时不可用，请稍后再试。
  • 部分地区访问海外 API（如 OpenAI）可能受限，可在 设置 → 通用设置 → 网络代理 中配置代理。

• 网络代理未生效

  • 若已开启代理，请确认 NextAI 已获得系统网络访问权限；
  • 建议使用 HTTP 或 SOCKS5 代理，并确保地址和端口正确。

🔑 模型与 API 配置问题

• API Key 错误

  • 请重新复制并粘贴 Key，确认无多余空格或换行；
  • 若仍报错，可尝试重置 Key 或在服务商控制台生成新 Key。

• Base URL 填写错误

  • 请填写模型服务接口地址（如 https://api.openai.com/v1），
    而非网页或控制台链接。
  • 可参考 API 配置说明 章节。

• 添加后仍提示“请先添加模型提供方”

  • 请检查提供方是否 启用；
  • Base URL 与 Key 是否正确；
  • 当前网络能否访问该域名（某些企业/校园网会限制外部 API）。

📦 导出与文件问题

• 图片或 PDF 导出失败

  • 请确保授予 NextAI 文件读写权限；
  • 若仍失败，可尝试切换网络或重启应用后再导出；
  • 导出内容较多时建议等待数秒，避免切换到后台。

• 附件无法上传

  • 请确认文件大小未超过限制（通常 10MB 内）；
  • 若为图片，请检查格式是否为 JPG/PNG。

⚠️ 错误码速查表

错误码	含义	处理建议
400	参数错误 / 请求格式不正确	检查输入或模型设置是否符合要求
401	API Key 无效或未授权	重新配置 Key 或检查权限
403	禁止访问（账号或区域受限）	更换网络或联系服务商支持
404	路径错误	检查 Base URL 是否完整（含 /v1）
429	请求过多（限速）	减少请求频率或提升配额
500	服务端内部错误	稍后重试或切换模型
503	服务临时不可用	等待数分钟后再次尝试

🌐 网络排查技巧

1. 打开手机浏览器，直接访问模型 API 地址（如 https://api.openai.com/v1）；
2. 若无法访问，说明当前网络被屏蔽；
3. 可切换至家庭网络 / 移动热点，或在设置中启用代理；
4. 若仍异常，请执行「删除提供方 → 重新添加」操作以重置配置。

💬 反馈与支持

如果以上方法仍无法解决问题，请前往
👉 问题反馈页面
提交详细信息（包括错误码与截图），我们会尽快协助处理。