故障排查
登录相关
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 登录后立即跳回登录页 | 浏览器禁用了 Cookie / 本地存储 | 允许第三方 Cookie，或使用无痕窗口排查插件 |
| 提示「登录失败」 | 账号密码错误或服务异常 | 核对密码；稍后重试；查看 API 健康状态 |
| 微信扫码无响应 | 未在小程序内授权 / 二维码过期 | 刷新二维码重试 |
| 忘记密码邮件未收到 | 邮箱错误 / 进入垃圾箱 | 检查垃圾邮件；确认邮箱拼写 |
查询相关
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 搜索结果为空 | 关键词拼写差异 / 数据未覆盖 | 改用 CNPJ 查询；检查是否含特殊字符 |
| 详情页 404 | CNPJ 不在本地数据集中 | 核对 CNPJ 校验位；确认企业确实在巴西注册 |
| 页面提示配额用尽 | 本月额度耗尽 | 在「账单与套餐」升级 |
| 付费 Tab 显示引导卡片 | 套餐不含该能力 | 升级套餐后重试 |
| 数据明显陈旧 | 同步批次滞后 | 查看「最后更新时间」，等待下个同步周期 |
API 相关
| HTTP | 错误码 | 含义 | 处理 |
|---|---|---|---|
| 400 | INVALID_PARAM | 参数格式错误 | 检查 CNPJ 位数与关键字长度 |
| 401 | UNAUTHORIZED | 缺少或无效的凭据 | 确认 Authorization: Bearer <API_KEY> |
| 403 | FORBIDDEN | 无 权限访问该资源 | 确认套餐与项目权限 |
| 404 | NOT_FOUND | 资源不存在 | 核对 CNPJ；未收录即不存在 |
| 409 | CONFLICT | 资源冲突 | 幂等重试或联系支持 |
| 422 | UNPROCESSABLE | 业务校验失败 | 查看 error.details |
| 429 | RATE_LIMITED | 触发限流或配额用尽 | 退避重试或升级套餐 |
| 500 | INTERNAL_ERROR | 服务内部错误 | 携带 request_id 联系支持 |
| 503 | SERVICE_UNAVAILABLE | 依赖服务不可用 | 稍后重试 |
1.
request_id；2.
3.
request_id + 请求时间 + 请求参数给支持团队。账单相关
| 现象 | 处理 |
|---|---|
| 支付后套餐未生效 | 等待 10 秒后刷新；仍未生效则提供订单号联系支持 |
| 订单长期「待支付」 | 二维码超时，关闭后重新下单 |
| 账单列表加载失败 | 刷新页面；确认登录态未过期 |
页面异常
| 现象 | 处理 |
|---|---|
| 白屏 | 强制刷新（Ctrl/Cmd + Shift + R）；清除缓存 |
| 样式错乱 | 确认浏览器为最新版 Chrome / Edge / Safari |
| 数据不刷新 | 切换菜单再返回，或刷新页面 |
修改于 2026-10-30 05:41:01