背景痛点：移动端集成 ChatGPT 的三座大山

1. 下载阶段：官方安装包（APK/IPA）仅面向北美区 App Store/Google Play，国内开发者需频繁切换账号或依赖镜像站，极易触发行级风控导致账号封禁。
2. SDK 集成：OpenAI 官方仅提供 REST 接口，无 Android 原生 SDK；社区版 chatgpt-android 仍引用旧版 support-library，与现有 AndroidX 项目出现 DuplicateClass 冲突。
3. API 调用：移动端无法像服务端那样持久保存 Secret Key，若将 Key 硬编码或放入 SharedPreferences 将面临逆向泄露；同时缺少 Token 刷新与并发限流机制，429 状态码触发后无重试策略，用户体验直接“躺平”。

技术对比：官方 REST vs 第三方封装

结论：对体积敏感场景（如插件化应用）建议直接调用官方 REST；对快速 MVP 验证可先用第三方库，上线前务必迁移到官方接口并补齐证书校验。

核心实现：Kotlin 示例工程

以下示例基于 Kotlin 1.9 + OkHttp 4.12，最小 SDK 21，目标 SDK 34。

1. 带指数退避重试的 API 调用

object ChatGPTClient {
    private const val BASE_URL = "https://api.openai.com/v1/"
    private val okHttp = OkHttpClient.Builder()
        .connectTimeout(10, TimeUnit.SECONDS)
        .addInterceptor(RetryInterceptor(maxRetry = 3))
        .build()

    /**
     * 发送对话请求
     * @param messages 上下文数组
     * @return 模型回复文本
     */
    suspend fun chatCompletion(messages: List<Message>): String {
        val body = ChatRequest(
            model = "gpt-3.5-turbo",
            messages = messages,
            temperature = 0.7
        )
        val request = Request.Builder()
            .url("${BASE_URL}chat/completions")
            .addHeader("Authorization", "Bearer ${TokenHolder.accessToken}")
            .post(Gson().toJson(body).toRequestBody("application/json".toMediaType()))
            .build()

        return withContext(Dispatchers.IO) {
            val response = okHttp.newCall(request).execute()
            if (!response.isSuccessful) throw IOException("HTTP ${response.code}")
            val dto = Gson().fromJson(response.body?.string(), ChatResponse::class.java)
            dto.choices.first().message.content
        }
    }
}

/**
 * 指数退避重试拦截器
 */
class RetryInterceptor(private val maxRetry: Int) : Interceptor {
    private var retryCount = 0

    override fun intercept(chain: Chain): Response {
        val request = chain.request()
        var response = chain.proceed(request)
        while (retryCount < maxRetry && response.code == 429) {
            val wait = (2.0.pow(retryCount) * 1000).toLong()
            Thread.sleep(wait)
            response.close()
            response = chain.proceed(request)
            retryCount++
        }
        return response
    }
}

2. OAuth2.0 身份验证最佳实践

移动端推荐使用 App-to-App Custom Tab 方案，避免输入密码被键盘记录。

class OAuthActivity : AppCompatActivity() {
    private val authService by lazy { AuthorizationService(this) }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val req = AuthorizationRequest.Builder(
            /* clientId    = */ BuildConfig.OAUTH_CLIENT_ID,
            /* responseType= */ "code",
            /* redirectUri = */ Uri.parse("com.example.chatgpt://oauth2redirect")
        ).setScope("openid").build()

        val intent = authService.getAuthorizationRequestIntent(req)
        startActivityForResult(intent, RC_AUTH)
    }

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) behind {
        if (requestCode == RC_AUTH && resultCode == RESULT_OK) {
            val resp = AuthorizationResponse.fromIntent(data!!)
            resp.authorizationCode?.let { code ->
                exchangeCodeForToken(code) // 后台换取 access_token & refresh_token
            }
        }
    }
}

Token 存储使用 Android Keystore 加密的 EncryptedSharedPreferences，保证即使 Root 也无法直接读取原始字符串。

性能优化：让低端机也能流畅对话

1. 请求批处理：将 3 秒内用户连续输入合并为一次网络请求，减少 40% 上行流量。
2. 本地缓存：对相同 system + user 内容做 MD5 作为键，缓存 5 分钟，降低重复提问延迟至 0 ms。
3. 网络监听：注册 ConnectivityManager.NetworkCallback，在弱网（2G/ congested Wi-Fi）环境自动下调 max_tokens 与 temperature，减少回包体积。

val networkCallback = object : ConnectivityManager.NetworkCallback() {
    override fun onCapabilitiesChanged(
        network: Network,
        capabilities: NetworkCapabilities
    ) {
        val isPoor = !capabilities.hasCapability(NET_CAPABILITY_NOT_METERED) &&
                     !capabilities.hasCapability(NET_CAPABILITY_NOT_VPN)
        ChatGPTClient.setPoorNetwork(isPoor)
    }
}

避坑指南：生产环境三大血泪教训

1. 忽略 429 状态码：未做退避导致账号被临时封禁 24 h；务必使用上文 RetryInterceptor。
2. 把 Secret Key 打包进 APK：被逆向工具 30 秒扫出，造成额度盗刷；应改用用户粒 OAuth + 服务端中继。
3. 未对齐后台计费日志：客户端按 prompt_tokens + completion_tokens 计算费用，与后台 total_tokens 口径不一致，导致财务对账差异；建议直接读取 Response 中的 usage.total_tokens 字段入库。

代码规范小结

• 遵循 Kotlin 官方 Coding Conventions，文件级函数使用驼峰，类名使用 Pascal。
• 公共接口必须添加 @WorkerThread 或 @MainThread 注解，配合 Dispatchers 防止阻塞 UI。
• 所有魔法数字（如 3 次重试、2 秒超时）统一放到 build.gradle.kts 的 buildConfigField，方便 CI 根据环境注入。

延伸思考：跨平台一次开发

若需同时覆盖 iOS，可基于 Flutter 插件 openai_api_chat（社区版）做二次封装：

• MethodChannel 负责传递 accessToken 与对话结果；
• 在 Dart 侧实现与 Android 相同的批处理 + 缓存策略，保持双端逻辑一致；
• 使用 package:connectivity_plus 监听弱网，与原生 NetworkCallback 对齐。

通过 FFI 直接调用 C++ 层 llama.cpp 量化模型也是可行方向，可在无网场景离线运行 3B 参数小模型，实现“端 - 云”双模态。

我在验证上述方案时，直接采用了「从0打造个人豆包实时通话AI」动手实验中的语音流式架构思路，将 ASR→LLM→TTS 链路迁移到移动端，发现其重试与缓存策略同样适用于 ChatGPT 场景。若你已掌握 Kotlin 网络层封装，不妨参考该实验进一步把“语音输入”与“语音输出”补齐，实现真正的低延迟对话体验。