1. 从一次 ANR 说起：Activity 与 Service 调试链路到底难在哪
如果你刚开始学 Android 四大组件，大概率会遇到这种场景：Activity 里点个按钮启动 Service，日志里 onCreate、onStartCommand 都打印了，但 Service 里那个网络请求就是没反应，或者界面直接卡死弹出 ANR 对话框。更让人头疼的是，你明明在 Service 里写了耗时逻辑，也开了线程，可日志顺序就是不对，onStartCommand 返回值的差异又让 Service 被杀后行为完全不同。
这个问题的本质在于：Activity 和 Service 虽然同属四大组件，但它们的生命周期、线程模型、启动方式差异很大。Activity 跑在主线程，生命周期跟着用户操作走；Service 默认也跑在主线程，但它的生命周期由 startService 或 bindService 决定，而且 onStartCommand 的返回值会直接影响系统在内存紧张时的回收策略。你如果只盯着代码看，不把启动流程和日志串起来，很难定位问题。
我试过在真机上反复点按钮启动 Service，结果发现同一个 Service 被启动了三次，onCreate 只走了一次，onStartCommand 却走了三次，startId 每次都不一样。这就是典型的「以为 Service 会重复创建」的误解。要验证这些行为，光靠 Logcat 手动翻日志效率很低，你需要一套可复制的调试链路：AndroidManifest 配置、adb 启动命令、日志过滤规则，再加上一个统一的请求通道来验证组件间通信。
这篇内容面向 Android 初学者，聚焦 Activity 与 Service 的启动流程与生命周期验证。我会给出可直接复制的 AndroidManifest 片段、adb 命令和日志过滤规则，并演示如何把本地调试请求的 Base URL 改到 TaoToken 统一 Key 通道，最后用一次完整调用验证组件间通信是否正常。你跟着做一遍，就能把「组件启动」和「网络请求」这两件事串成一条可观测的链路。
先说清楚适合谁：如果你已经能跑起一个 Hello World 的 Android 项目，知道 Activity 的基本写法，但对 Service 的启动方式、生命周期回调顺序、以及怎么在调试阶段统一管理请求 Key 还比较模糊，那这篇就是为你准备的。不需要你懂 AIDL 跨进程，也不需要你配 Gradle 插件，只要会用 adb 和看 Logcat 就行。
核心检索词先摆出来：Android 四大组件、Activity 生命周期、Service 启动方式、adb 启动 Service、Logcat 过滤、TaoToken 统一 Key。这几个词会贯穿全文，你搜到这篇大概率也是因为其中某一个。
接下来我会先讲 TaoToken 的前置准备，再给可复制的配置，然后验证请求，最后排错。每一步都有命令和结果说明，你照着敲就行。
2. TaoToken 前置准备：统一 Key 通道与 Base URL 替换思路
在调试 Activity 与 Service 通信时，一个很现实的问题是：你的 Service 里可能要发网络请求，比如下载配置、上报日志、拉取数据。如果每个调试环境都硬编码不同的 API 地址和 Key，代码里到处是BuildConfig.DEBUG判断，改起来容易漏。更麻烦的是，团队里每个人本地 Key 不一样，联调时经常出现「我这边能通你那边 401」。
TaoToken 在这里的角色是一个统一的请求入口。你可以把它理解成一个「请求中转站」：你的 App 不管在哪个调试环境，Base URL 都指向同一个地址，Key 也用同一套，模型 ID 在请求体里指定。这样 Activity 和 Service 发请求时，代码里不需要区分环境，调试链路自然就统一了。
官网地址是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。注意 API 地址不带 UTM 参数，直接用于代码里的 Base URL。
你需要先拿到一个 API Key。进入控制台创建 Key 的路径是：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。创建完之后复制那串 Key，后面配置里会用到。如果你只是想先验证模型能不能通，可以用模型对话页面快速试一下：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。
这里要强调一个概念：Base URL 和 Key 是两件事。Base URL 决定请求发到哪里，Key 决定你有没有权限。很多初学者把两者混在一起，以为换了 Key 就等于换了服务地址，其实不是。在 Android 项目里，你通常会把 Base URL 放在build.gradle的buildConfigField里，Key 放在local.properties或环境变量里，避免提交到 Git。
为什么要在 Activity 与 Service 调试里引入这个统一通道？因为 Service 的调试比 Activity 更麻烦。Activity 你能看到界面，能点按钮，能立刻看到结果；Service 在后台跑，你只能靠日志和通知判断它有没有工作。如果 Service 里的请求还因为 Key 不对返回 401，你就要同时排查「Service 有没有启动成功」和「请求有没有发出去」两个问题。统一 Key 通道之后，请求这一层的行为是确定的，你就能把精力集中在组件生命周期上。
具体做法是：在 Service 的onStartCommand里发起一个请求，请求的 Base URL 指向 TaoToken 的 API 地址，Header 里带Authorization: Bearer <你的Key>，请求体里指定模型 ID。然后你在 Logcat 里过滤这个 Service 的 TAG，看请求前后的日志顺序。如果请求成功返回，说明 Service 的启动、线程切换、网络调用整条链路是通的；如果失败，你也能根据错误码快速定位是 Key 问题还是组件问题。
还有一个细节：Service 默认在主线程，网络请求必须放到子线程。你可以用HandlerThread或者Executors.newSingleThreadExecutor()。我在示例里会用HandlerThread，因为它在 Service 里管理起来比较干净，onDestroy时调用quitSafely()就能释放。
拿到 Key 之后，先别急着写代码。你可以用 curl 在电脑上验证一下 Key 是否有效，命令如下：
curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 你的Key" \ -d '{ "model": "你的模型ID", "messages": [{"role": "user", "content": "ping"}] }'如果返回里有choices字段，说明 Key 和 Base URL 都没问题。这一步能帮你排除掉后面 Android 代码里的网络配置干扰。如果这里就报 401，那先去检查 Key 有没有复制完整，或者是不是用了错误的 API 路径。
确认 Key 可用之后，我们再进入 Android 项目的配置。记住，TaoToken 在这里是统一请求通道，不是替代你的编辑器或 IDE，你的代码还是在 Android Studio 里写，只是请求的出口统一了。
3. 可复制配置：AndroidManifest、adb 命令与请求参数
这一节是全文操作最密集的部分，你跟着复制就行。我会分三块：AndroidManifest 配置、adb 启动与日志命令、以及 Service 里请求 TaoToken 的代码片段。
3.1 AndroidManifest 配置片段
先看 AndroidManifest.xml。假设你有一个MyService和一个MainActivity，配置如下：
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.componentdemo"> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <application android:allowBackup="true" android:label="ComponentDemo" android:theme="@style/Theme.AppCompat.Light"> <activity android:name=".MainActivity" android:exported="true"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <service android:name=".MyService" android:exported="false" android:foregroundServiceType="dataSync" /> </application> </manifest>几个关键点解释一下。INTERNET权限是必须的，否则请求直接抛异常。android:exported="false"表示这个 Service 只允许本应用启动，调试阶段够用；如果你要做跨进程调用，才需要设成 true 并配 intent-filter。foregroundServiceType是 Android 10 之后的要求，如果你要把 Service 提升为前台服务，需要指定类型，这里用dataSync表示数据同步。
注意：从 Android 8.0 开始，后台 Service 受到限制，如果你在 App 退到后台后启动 Service，可能会被系统拒绝。调试时建议让 Activity 保持在前台，或者用startForegroundService并配套通知。本文示例为了聚焦生命周期，先用startService在 Activity 前台时启动。
3.2 adb 启动命令与日志过滤
adb 是调试组件最直接的工具。先确认设备连接：
adb devices看到设备序列号后，你可以用 am 命令直接启动 Service，不用点界面：
adb shell am startservice -n com.example.componentdemo/.MyService如果 Service 需要传参，可以加-e：
adb shell am startservice -n com.example.componentdemo/.MyService -e "action" "download"启动 Activity 的命令类似：
adb shell am start -n com.example.componentdemo/.MainActivity日志过滤是重点。Logcat 默认输出太多，你需要按 TAG 过滤。假设你的 Service 里 TAG 是MyService，命令如下：
adb logcat -s MyService:V MainActivity:V AndroidRuntime:E-s表示只显示指定 TAG，V是 verbose 级别，E是 error。这样你就能看到 Service 和 Activity 的日志，以及崩溃信息。如果你想看生命周期相关的系统日志，可以加ActivityManager：
adb logcat -s MyService:V ActivityManager:I还有一个实用技巧：把日志输出到文件，方便对比多次启动的顺序：
adb logcat -s MyService:V > service_log.txt然后你在另一个终端执行启动命令，日志会实时写入文件。验证完按 Ctrl+C 停止。
3.3 Service 请求 TaoToken 的配置片段
下面这段代码放在MyService.java里，展示如何在onStartCommand中通过 HandlerThread 发起请求。Base URL 指向 TaoToken API，Key 从常量读取（实际项目建议放 BuildConfig）。
package com.example.componentdemo; import android.app.Service; import android.content.Intent; import android.os.Handler; import android.os.HandlerThread; import android.os.IBinder; import android.util.Log; import java.io.BufferedReader; import java.io.InputStreamReader; import java.io.OutputStream; import java.net.HttpURLConnection; import java.net.URL; public class MyService extends Service { private static final String TAG = "MyService"; private static final String BASE_URL = "https://taotoken.net/api/v1/chat/completions"; private static final String API_KEY = "你的Key"; private static final String MODEL_ID = "你的模型ID"; private HandlerThread handlerThread; private Handler handler; @Override public void onCreate() { super.onCreate(); Log.d(TAG, "onCreate called"); handlerThread = new HandlerThread("MyServiceThread"); handlerThread.start(); handler = new Handler(handlerThread.getLooper()); } @Override public int onStartCommand(Intent intent, int flags, int startId) { Log.d(TAG, "onStartCommand called, startId=" + startId); handler.post(new Runnable() { @Override public void run() { doRequest(); } }); return START_REDELIVER_INTENT; } private void doRequest() { HttpURLConnection conn = null; try { URL url = new URL(BASE_URL); conn = (HttpURLConnection) url.openConnection(); conn.setRequestMethod("POST"); conn.setRequestProperty("Content-Type", "application/json"); conn.setRequestProperty("Authorization", "Bearer " + API_KEY); conn.setDoOutput(true); conn.setConnectTimeout(10000); conn.setReadTimeout(30000); String body = "{\"model\":\"" + MODEL_ID + "\",\"messages\":[{\"role\":\"user\",\"content\":\"ping\"}]}"; OutputStream os = conn.getOutputStream(); os.write(body.getBytes("UTF-8")); os.close(); int code = conn.getResponseCode(); Log.d(TAG, "response code=" + code); BufferedReader reader = new BufferedReader(new InputStreamReader( code >= 200 && code < 300 ? conn.getInputStream() : conn.getErrorStream())); StringBuilder sb = new StringBuilder(); String line; while ((line = reader.readLine()) != null) { sb.append(line); } reader.close(); Log.d(TAG, "response body=" + sb.toString()); } catch (Exception e) { Log.e(TAG, "request failed", e); } finally { if (conn != null) conn.disconnect(); } } @Override public void onDestroy() { super.onDestroy(); Log.d(TAG, "onDestroy called"); if (handlerThread != null) { handlerThread.quitSafely(); } } @Override public IBinder onBind(Intent intent) { return null; } }这段代码里，onCreate只会在第一次启动时调用，onStartCommand每次startService都会调用，startId递增。请求放在 HandlerThread 里，避免主线程阻塞。返回START_REDELIVER_INTENT表示 Service 被杀后重建时会重新传入最后的 Intent。
如果你用的是 Kotlin，逻辑一样，只是语法不同。这里用 Java 是为了让初学者更容易对照生命周期回调。
配置部分就这些。接下来我们实际跑一次，看日志和请求结果。
4. 验证请求：从 adb 启动到日志确认组件通信
现在把前面的配置串起来跑一遍。你需要一个能编译运行的 Android 项目，把MyService和MainActivity加进去，Manifest 按上面配好。然后按以下步骤操作。
第一步，安装 App 到设备：
./gradlew installDebug或者直接在 Android Studio 点 Run。安装完成后，先别点界面，我们用 adb 启动 Service，这样日志更干净。
第二步，清空 Logcat 并开始过滤：
adb logcat -c adb logcat -s MyService:V ActivityManager:I AndroidRuntime:E-c是清空历史日志，避免干扰。
第三步，启动 Service：
adb shell am startservice -n com.example.componentdemo/.MyService这时你应该在 Logcat 里看到类似输出：
D/MyService: onCreate called D/MyService: onStartCommand called, startId=1 D/MyService: response code=200 D/MyService: response body={"choices":[...]}如果看到response code=200并且 body 里有choices，说明整条链路通了：Service 启动成功、HandlerThread 工作正常、TaoToken 请求返回成功。这就是组件间通信验证的核心结果。
第四步，再启动一次 Service，观察 startId 变化：
adb shell am startservice -n com.example.componentdemo/.MyService这次日志应该是：
D/MyService: onStartCommand called, startId=2 D/MyService: response code=200注意onCreate没有再出现，因为 Service 已经存在。startId变成 2，说明系统在区分不同的启动请求。这个细节在排查「Service 被重复创建」时非常有用。
第五步，停止 Service：
adb shell am stopservice -n com.example.componentdemo/.MyService日志里会出现onDestroy called。如果你在onDestroy里没有释放 HandlerThread，这里可能会看到线程泄漏的警告。
第六步，验证 Activity 与 Service 的通信。在MainActivity里加一个按钮，点击后startService，然后看日志顺序。你可以用adb shell input tap模拟点击，但更简单的是直接在界面上点。日志里应该先出现 Activity 的生命周期，再出现 Service 的。如果你用bindService，还会看到onBind和onServiceConnected的回调。
这里有一个容易忽略的点：Service 的onStartCommand返回值。你可以把返回值改成START_NOT_STICKY，然后手动在设置里强制停止 App，再观察 Service 是否重建。对比START_STICKY和START_REDELIVER_INTENT的行为差异，能帮你真正理解这三个常量的含义。
验证请求成功之后，你可以把 Base URL 换成其他路径测试错误处理，比如故意把 Key 改错，看是否返回 401。这样你就能区分「组件问题」和「鉴权问题」。
如果你在验证模型响应内容，可以打开模型对话页面手动发一条消息对比：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。这样你能确认返回格式和代码里解析的是否一致。
整个验证过程的核心就是：用 adb 控制组件启动，用 Logcat 观察生命周期顺序，用请求结果确认通信链路。三步都通过，说明你的 Activity 与 Service 调试链路是健康的。
5. 本篇常见错排查：401、local proxy failed 与 reading choices
调试过程中最容易卡住的不是代码写错，而是报错信息看不懂。这一节我把几个高频错误和排查路径列出来，你对照自己的日志找。
5.1 401 Unauthorized
这是最常见的。日志里通常长这样：
D/MyService: response code=401 D/MyService: response body={"error":{"message":"Invalid API key"}}原因有三个：Key 复制不完整、Key 前后有空格、或者 Header 拼写错误。检查Authorization的值是不是Bearer加 Key，注意 Bearer 后面有一个空格。另外确认你用的是 TaoToken 控制台创建的 Key，路径是 https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。
如果你在电脑上用 curl 能通，Android 上不通，那大概率是 Key 被硬编码时被截断，或者local.properties读取有问题。建议先在代码里直接写死 Key 测试，确认通了再改成 BuildConfig。
5.2 local proxy failed
这个报错通常出现在你本地配了代理工具的情况下。日志可能是：
D/MyService: request failed java.net.ConnectException: failed to connect to /127.0.0.1:7890这说明你的代码或系统把请求转发到了本地代理端口，但代理没开或者端口不对。排查方法是检查HttpURLConnection有没有设置Proxy，以及设备 WiFi 设置里有没有配手动代理。如果你不需要代理，把代理关掉，或者用conn.setProxy(Proxy.NO_PROXY)显式禁用。
注意：这里说的代理是网络请求层面的代理配置，不是让你去用什么特殊工具。调试阶段保持网络配置干净，能减少很多干扰。
5.3 reading choices 相关解析错误
如果你在解析响应时用了 Gson 或手动取字段，可能会遇到：
com.google.gson.JsonSyntaxException: java.lang.IllegalStateException: Expected BEGIN_OBJECT but was STRING或者日志里 body 是空的，但 code 是 200。这通常是因为响应格式和你预期的不一样。先打印完整 body，确认有没有choices数组。如果 body 是 HTML 错误页，说明 Base URL 路径写错了，比如漏了/v1。
还有一种情况是流式响应。如果你在请求体里加了"stream": true，返回的是 SSE 格式，不是标准 JSON，直接按 JSON 解析就会报错。调试阶段建议先不加 stream，等链路通了再改。
5.4 OAuth 或鉴权头冲突
如果你同时用了其他 SDK，可能会在请求头里带上额外的Authorization，导致覆盖或冲突。日志里可能看到：
D/MyService: response code=403 D/MyService: response body={"error":{"message":"Forbidden"}}排查方法是把最终请求头打印出来，确认只有一个Authorization，且值是Bearer <TaoToken Key>。如果你在项目里用了 OkHttp 的拦截器，检查拦截器有没有重复添加头。
5.5 Service 启动失败或 onStartCommand 不执行
如果 adb 命令返回Error: Not found; no service started，说明组件名写错了。确认-n后面的包名和类名与 Manifest 一致。如果 App 没安装，先adb install。
如果onStartCommand不执行，但onCreate执行了，检查是不是在onCreate里抛了异常。Logcat 里过滤AndroidRuntime能看到崩溃栈。
5.6 三件套检查清单
无论遇到哪种错误，先确认这三件套是否齐全：Base URL、Key、Model ID。Base URL 用https://taotoken.net/api/v1/chat/completions，Key 用控制台创建的，Model ID 用你账号可用的。三者缺一不可。如果你在 Cline、Codex 或 Claude Code 里配置，也是同样的三件套逻辑，只是配置文件位置不同。
排障的时候，建议把请求和响应都打全，包括 header 和 body。日志越完整，定位越快。如果你需要更详细的接入说明，可以看接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。
6. 继续深入：把调试链路用到长期编码与 Agent 场景
到这里，你已经完成了 Activity 与 Service 的启动验证、日志观察和请求打通。这套链路不只用于初学调试，它其实是你后续做长期编码和 Agent 开发的基础设施。
为什么这么说？因为当你开始用 AI 辅助编码，比如在 IDE 里接 Coding Plan，或者在命令行里跑 Claude Code，你同样需要一套稳定的请求通道。Activity 与 Service 的调试链路验证的是「组件能不能启动、请求能不能通」，而 Coding Plan 验证的是「模型能不能持续响应、上下文能不能保持」。两者的底层都是 Base URL 加 Key 加 Model ID 这三件套。
如果你打算把调试环境固定下来，建议把 Key 放到环境变量或local.properties，Base URL 放到build.gradle的buildConfigField，Model ID 也做成可配置。这样你在 Activity、Service、甚至单元测试里都能复用同一套配置，不用每次改代码。
对于需要长期跑编码任务的场景，可以了解 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。它适合那种需要持续对话、多轮修改代码的工作流。而如果你只是偶尔验证模型输出，用模型对话页面就够了。
还有一个实用技巧：把 adb 日志过滤命令写成脚本，每次调试前跑一下。比如建一个debug_service.sh：
#!/bin/bash adb logcat -c adb logcat -s MyService:V MainActivity:V AndroidRuntime:E然后另开终端执行adb shell am startservice。这样你每次都能看到干净的生命周期日志，不用手动翻。
最后提醒一点：Service 的onStartCommand返回值要根据实际场景选。如果你做的是下载任务，用START_REDELIVER_INTENT；如果是背景音乐，用START_STICKY；如果是一次性任务，用START_NOT_STICKY。选错了会导致 Service 被杀后行为不符合预期，这在长时间运行的 Agent 场景里尤其明显。
把这篇的配置跑一遍，你应该能独立完成 Activity 与 Service 的启动验证和请求调试。后面再遇到组件通信问题，先看 Logcat 的生命周期顺序，再确认三件套，基本能定位大部分问题。
