故障排查指南

OpenDev 平台集成常见问题与解决方案。

认证问题

OAuth 登录失败：Invalid Client

现象： invalidclient 或 clientid is invalid，登录弹窗立即关闭。

解决：

1. 核对 Client ID：OpenDev > Apps > OAuth Channels，确认与提供商控制台一致
2. 检查提供商：OAuth 应用已启用、重定向 URI 正确、生产模式
3. Google 特殊：启用所需 API、配置同意屏幕、添加授权域名

Redirect URI Mismatch

现象： redirecturimismatch，开发正常、生产失败。

解决：

1. 完全匹配：提供商与 OpenDev 中的 URI 须完全一致（含尾部斜杠）
2. 协议：生产环境必须使用 HTTPS
3. 多环境：开发用 localhost，生产用正式域名

Apple Sign In 在 Web 上不工作

现象： 弹窗出现后立即关闭，或 invalid_request。

解决：

1. 为 Web 使用独立的 Service ID（非 App ID）
2. 配置域名与返回 URL
3. 确认私钥与 Service ID 关联正确

支付问题

Webhook 收不到

解决：

1. URL 公网可访问、使用 HTTPS
2. 检查防火墙规则
3. 查看提供商重试策略与日志

支付失败

解决：

1. 测试环境使用测试卡号
2. 正式环境核对卡信息与风控规则
3. 查看 Webhook 事件与错误日志

API 问题

401 Unauthorized

解决： Token 过期、凭据错误、Authorization 头缺失、环境/凭据不匹配。

相关文档

• 集成常见问题
• 安全常见问题