集成常见问题
关于 OpenDev 平台集成的常见问题与解答。
OAuth 集成
Q：支持哪些 OAuth 提供商？
A： OpenDev 支持以下 OAuth 提供商：
- Google - 全球用户
- Facebook - 全球用户
- Apple Sign In - iOS、macOS、Web
- WeChat - 中国市场用户
- QQ - 中国市场用户
Q：回调 URL 格式是什么？
A： 根据环境使用不同格式：
生产：https://yourdomain.com/auth/{provider}/callback
开发：http://localhost:3000/auth/{provider}/callback将 {provider} 替换为：google、facebook、apple、wechat、qq。
Q：OAuth 错误如何处理？
A： 常见错误与解决方案：
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| invalid_client | 客户端 ID 或密钥错误 | 在 OpenDev 中核对 OAuth 凭据 |
| redirecturimismatch | 回调 URL 不匹配 | 确保提供商控制台与 OpenDev 配置一致 |
| access_denied | 用户拒绝授权 | 友好提示用户 |
| invalid_scope | 请求的 scope 不允许 | 查阅提供商文档确认有效 scope |
Q：可以为不同环境使用同一 OAuth 配置吗？
A： 建议各环境使用独立 OAuth 应用：开发、预发布、生产分别配置，便于安全与调试。
支付集成
Q：支持哪些支付方式？
A： OpenDev 支持：
- Stripe - 信用卡、钱包（Web、Desktop）
- Google Play Billing - Android 内购
- Apple In-App Purchase - iOS/macOS 内购
- WeChat Pay - 微信支付
Q：开发环境如何测试支付？
A： 各提供商均有沙箱/测试模式：
| 提供商 | 测试配置 |
|---|---|
| Stripe | 使用测试密钥（sktest） |
| Google Play | 在控制台添加测试账号 |
| Apple IAP | 在 App Store Connect 使用沙箱 |
| WeChat Pay | 申请沙箱商户账号 |
Q：如何处理支付 Webhook？
A： 建议：
- 验证签名 - 校验 Webhook 签名
- 幂等性 - 正确处理重复事件
- 快速响应 - 5 秒内返回 200
- 异步处理 - 耗时逻辑放后台队列
- 日志 - 记录所有 Webhook 便于排查
SDK 集成
Q：支持哪些平台？
A： OpenDev SDK 支持：iOS、Android、Desktop、Web、Server（Node.js、Python、Java）。
Q：最低 SDK 版本要求？
A：
- iOS：12.0+
- Android：API 21+
- Desktop：Windows 10+、macOS 10.14+
- Web：ES6+ 浏览器
Q：如何调试 SDK 问题？
A：
- 开启调试日志：配置中设置
debug: true - 查看控制台日志
- 确认 App ID 和凭据正确
- 使用 Charles/Fiddler 检查网络请求
配置
Q：如何生成配置包？
A：
- 进入 OpenDev > Apps
- 选择应用
- 进入 Configuration Delivery
- 选择环境
- 点击 Generate Configuration
- 下载并集成到应用中
故障排查
Q：API 返回 401 Unauthorized
A： 可能原因：Token 过期、凭据错误、缺少 Authorization 头、环境/凭据不匹配。
Q：Webhook 收不到
A： 检查：URL 是否公网可访问、是否使用 HTTPS、防火墙规则、提供商重试策略。
Q：如何反馈 Bug 或功能建议？
A： 邮箱 contact@zinben.com，或在 OpenDev 控制台使用反馈表单。
最后更新：2026 年 1 月