Chucker Kotlin 调试库：完整指南与实战示例

1. 什么是 Chucker？为什么需要它？

Chucker 是一款强大的 Kotlin 编写的 Android 应用 HTTP 请求调试库。它能让开发者直接在设备上拦截、记录并检查所有通过 OkHttp 客户端传输的网络流量。与 Logcat 的标准日志记录不同，Chucker 提供了一个独立的图形界面（Activity），方便查看请求头、请求体、响应体、状态码、执行时间和数据大小。

Chucker 的核心目标是简化网络交互的调试过程。开发者无需将设备连接到电脑并筛选日志，只需打开应用即可看到所有 HTTP 事务。这在真实设备测试、ADB 访问受限或与 QA 团队协作时尤为实用——QA 人员可以直接提供包含详细请求信息的错误截图。

Chucker 还支持按内容类型（JSON、XML、图片）过滤、按 URL 搜索、查看错误和异常，以及将日志导出为文件。该库会自动收集 SSL 错误、超时和其他网络问题的信息，使其成为任何使用 REST API 的 Android 开发者的必备工具。

2. 安装指南

Chucker 通过 Maven Central 分发。要安装它，需要在应用模块的 build.gradle.kts（或 build.gradle）文件中添加依赖。

重要提示： 该库不适用于通过 pip、npm 或 cargo 安装。它是一款 Android 库，需通过 Gradle 构建系统引入。

在 build.gradle.kts（Module: app）中添加以下代码：

// build.gradle.kts (Module: app)
dependencies {
    // Chucker 主库（仅用于 debug 构建）
    debugImplementation("com.github.chuckerteam.chucker:library:4.0.0")

    // No-Op 库（用于 release 构建，空操作）
    releaseImplementation("com.github.chuckerteam.chucker:library-no-op:4.0.0")
}

对于 Groovy（build.gradle）：

// build.gradle (Module: app)
dependencies {
    debugImplementation 'com.github.chuckerteam.chucker:library:4.0.0'
    releaseImplementation 'com.github.chuckerteam.chucker:library-no-op:4.0.0'
}

说明： 使用 debugImplementation 确保 Chucker 仅在调试构建中可用。releaseImplementation 配合 library-no-op 版本会将所有 Chucker 调用替换为空函数，从而避免生产环境数据泄露，且不会增加 APK 体积。

3. 快速上手——最小工作示例

安装库后，需要创建一个 OkHttpClient 并添加 Chucker 拦截器。然后使用该客户端创建 Retrofit 或其他 HTTP 客户端。

// MainActivity.kt
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import com.chuckerteam.chucker.api.ChuckerCollector
import com.chuckerteam.chucker.api.ChuckerInterceptor
import okhttp3.OkHttpClient
import okhttp3.Request

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // 1. 创建日志收集器
        val collector = ChuckerCollector(this)

        // 2. 创建拦截器
        val chuckerInterceptor = ChuckerInterceptor.Builder(this)