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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。注意 API 地址不带 UTM 参数直接用于代码里的 Base URL。你需要先拿到一个 API Key。进入控制台创建 Key 的路径是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建完之后复制那串 Key后面配置里会用到。如果你只是想先验证模型能不能通可以用模型对话页面快速试一下https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。这里要强调一个概念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 version1.0 encodingutf-8? manifest xmlns:androidhttp://schemas.android.com/apk/res/android packagecom.example.componentdemo uses-permission android:nameandroid.permission.INTERNET / uses-permission android:nameandroid.permission.ACCESS_NETWORK_STATE / application android:allowBackuptrue android:labelComponentDemo android:themestyle/Theme.AppCompat.Light activity android:name.MainActivity android:exportedtrue intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity service android:name.MyService android:exportedfalse android:foregroundServiceTypedataSync / /application /manifest几个关键点解释一下。INTERNET权限是必须的否则请求直接抛异常。android:exportedfalse表示这个 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 需要传参可以加-eadb 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表示只显示指定 TAGV是 verbose 级别E是 error。这样你就能看到 Service 和 Activity 的日志以及崩溃信息。如果你想看生命周期相关的系统日志可以加ActivityManageradb logcat -s MyService:V ActivityManager:I还有一个实用技巧把日志输出到文件方便对比多次启动的顺序adb logcat -s MyService:V service_log.txt然后你在另一个终端执行启动命令日志会实时写入文件。验证完按 CtrlC 停止。3.3 Service 请求 TaoToken 的配置片段下面这段代码放在MyService.java里展示如何在onStartCommand中通过 HandlerThread 发起请求。Base URL 指向 TaoToken APIKey 从常量读取实际项目建议放 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是清空历史日志避免干扰。第三步启动 Serviceadb shell am startservice -n com.example.componentdemo/.MyService这时你应该在 Logcat 里看到类似输出D/MyService: onCreate called D/MyService: onStartCommand called, startId1 D/MyService: response code200 D/MyService: response body{choices:[...]}如果看到response code200并且 body 里有choices说明整条链路通了Service 启动成功、HandlerThread 工作正常、TaoToken 请求返回成功。这就是组件间通信验证的核心结果。第四步再启动一次 Service观察 startId 变化adb shell am startservice -n com.example.componentdemo/.MyService这次日志应该是D/MyService: onStartCommand called, startId2 D/MyService: response code200注意onCreate没有再出现因为 Service 已经存在。startId变成 2说明系统在区分不同的启动请求。这个细节在排查「Service 被重复创建」时非常有用。第五步停止 Serviceadb 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_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。这样你能确认返回格式和代码里解析的是否一致。整个验证过程的核心就是用 adb 控制组件启动用 Logcat 观察生命周期顺序用请求结果确认通信链路。三步都通过说明你的 Activity 与 Service 调试链路是健康的。5. 本篇常见错排查401、local proxy failed 与 reading choices调试过程中最容易卡住的不是代码写错而是报错信息看不懂。这一节我把几个高频错误和排查路径列出来你对照自己的日志找。5.1 401 Unauthorized这是最常见的。日志里通常长这样D/MyService: response code401 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_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。如果你在电脑上用 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 code403 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/completionsKey 用控制台创建的Model ID 用你账号可用的。三者缺一不可。如果你在 Cline、Codex 或 Claude Code 里配置也是同样的三件套逻辑只是配置文件位置不同。排障的时候建议把请求和响应都打全包括 header 和 body。日志越完整定位越快。如果你需要更详细的接入说明可以看接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。6. 继续深入把调试链路用到长期编码与 Agent 场景到这里你已经完成了 Activity 与 Service 的启动验证、日志观察和请求打通。这套链路不只用于初学调试它其实是你后续做长期编码和 Agent 开发的基础设施。为什么这么说因为当你开始用 AI 辅助编码比如在 IDE 里接 Coding Plan或者在命令行里跑 Claude Code你同样需要一套稳定的请求通道。Activity 与 Service 的调试链路验证的是「组件能不能启动、请求能不能通」而 Coding Plan 验证的是「模型能不能持续响应、上下文能不能保持」。两者的底层都是 Base URL 加 Key 加 Model ID 这三件套。如果你打算把调试环境固定下来建议把 Key 放到环境变量或local.propertiesBase URL 放到build.gradle的buildConfigFieldModel ID 也做成可配置。这样你在 Activity、Service、甚至单元测试里都能复用同一套配置不用每次改代码。对于需要长期跑编码任务的场景可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。它适合那种需要持续对话、多轮修改代码的工作流。而如果你只是偶尔验证模型输出用模型对话页面就够了。还有一个实用技巧把 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 的生命周期顺序再确认三件套基本能定位大部分问题。