1. Android 开发里那些“编译通过、运行崩溃”的坑
Android 开发最让人头疼的不是写不出功能，而是代码编译一路绿灯，装到真机上却直接崩给你看。TextView 颜色设了没生效、Cursor 一取值就抛CursorIndexOutOfBoundsException、SQLite 查询条件漏掉空值判断导致数据对不上——这些问题在 Android 圈子里几乎每个开发者都踩过。它们有个共同特征：类型系统帮不了你。setTextColor(R.color.white)传的是资源 ID，编译器当它是合法的 int；cursor.getString(1)在游标没移动前调用，编译器也看不出问题。等到运行时，异常才姗姗来迟。
这篇内容面向正在做 Android 应用开发、被这类“隐性错误”反复消耗时间的同学。我会把 TextView、Cursor、SQLite、Context、Service 注册这几个高频场景的典型错误拆开讲清楚，每个都给出错误写法、崩溃现象、正确写法和背后的原因。同时，因为现在很多团队会在开发流程里接入统一的模型 API 通道来做代码审查、日志分析或自动化排查，我也会给出一套可复制的 TaoToken 配置骨架（settings.json/config.toml），把 Key 管理和请求验证串起来，让你在排查这些 Android 错误时多一个顺手的工具。整套内容按“先讲错误、再配通道、最后验证排查”的顺序走，你可以直接跟着操作。
2. 先把 TaoToken 通道配好：统一 Key 与请求入口
在开始逐个排查 Android 错误之前，先把工具链准备好。TaoToken 提供统一的 API 入口，官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 基址是 https://taotoken.net/api 。它的作用是让你用一套 Key 和一套请求格式，去调用不同的模型能力，省掉每个服务单独配 Key、单独记 endpoint 的麻烦。对于 Android 团队来说，比较实用的场景是：把崩溃日志、CursorIndexOutOfBoundsException堆栈、SQLite 查询语句丢给模型做归因分析，或者让模型帮你 review 一段setTextColor的写法有没有问题。
你需要先拿到 API Key。进入控制台创建：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，然后在 API Keys 页面生成一个 Key：https://taotoken.net/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 。如果是要长期做编码辅助、Agent 自动排查，可以了解 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。接入细节和参数说明看文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。
注意：Key 不要硬编码进 Android 工程源码或提交到 Git。建议放在本地配置文件或环境变量里，下面给的
settings.json和config.toml就是干这个用的。
3. 可复制配置：settings.json 与 config.toml 骨架
这一节给出两份可直接复制的配置。settings.json适合放在项目根目录或本地开发环境，config.toml适合放在用户配置目录。两份配置的核心都是：base_url 指向 TaoToken 的 API 地址，api_key 从环境变量读取，模型名单独列出。这样你在排查 Android 错误时，切换模型只需要改一个字段，不用动代码。
3.1 settings.json 配置骨架
{ "provider": "taotoken", "base_url": "https://taotoken.net/api", "api_key_env": "TAOTOKEN_API_KEY", "default_model": "claude-sonnet", "timeout_seconds": 60, "max_retries": 2, "log_level": "info", "android_review": { "enabled": true, "include_patterns": [ "**/*.java", "**/*.kt", "**/AndroidManifest.xml" ], "ignore_patterns": [ "**/build/**", "**/.gradle/**" ] } }这份配置里，base_url固定为https://taotoken.net/api，不要在后面多加斜杠或路径。api_key_env表示 Key 从环境变量TAOTOKEN_API_KEY读取，你需要在 shell 里先导出：
export TAOTOKEN_API_KEY="你的Key"android_review这一段是给代码审查场景用的，include_patterns指定要扫描的 Android 源文件，ignore_patterns排除构建产物。这样你在排查TextView、Cursor、SQLite相关代码时，可以让工具只关注业务源码，不被build/目录里的生成文件干扰。
3.2 config.toml 配置骨架
[provider] name = "taotoken" base_url = "https://taotoken.net/api" api_key_env = "TAOTOKEN_API_KEY" default_model = "claude-sonnet" timeout_seconds = 60 max_retries = 2 [logging] level = "info" format = "text" [android] manifest_path = "app/src/main/AndroidManifest.xml" source_roots = ["app/src/main/java", "app/src/main/kotlin"] check_rules = [ "textview_color_resource", "cursor_move_before_get", "sqlite_null_condition", "service_manifest_registered", "context_start_activity_flag" ]check_rules里列的每一条，都对应本文后面要讲的 Android 错误类型。textview_color_resource对应setTextColor传资源 ID 的问题，cursor_move_before_get对应游标未移动就取值，sqlite_null_condition对应name <> 'zhangsan'漏掉空值，service_manifest_registered对应 Service 没在 Manifest 注册，context_start_activity_flag对应非 Activity Context 启动 Activity 缺FLAG_ACTIVITY_NEW_TASK。你可以按需增删。
3.3 参数对照表
| 配置项 | 作用 | 建议值 |
|---|---|---|
| base_url | API 请求基址 | https://taotoken.net/api |
| api_key_env | 读取 Key 的环境变量名 | TAOTOKEN_API_KEY |
| default_model | 默认调用的模型 | 按需选择 |
| timeout_seconds | 单次请求超时 | 60 |
| max_retries | 失败重试次数 | 2 |
| log_level | 日志级别 | info |
提示：两份配置不要同时用。选一份放在你的工具链能读到的地方即可。
settings.json适合项目级，config.toml适合用户级。
4. 验证请求：确认通道通了再排查 Android 错误
配置写好后，先验证通道能不能正常返回。最直接的方式是用curl发一个最小请求。下面这条命令把base_url、Key、模型名都串起来，返回内容里如果有正常的文本输出，说明通道没问题。
curl -s -X POST "https://taotoken.net/api/v1/messages" \ -H "Content-Type: application/json" \ -H "x-api-key: $TAOTOKEN_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet", "max_tokens": 256, "messages": [ { "role": "user", "content": "用一句话解释 Android 里 CursorIndexOutOfBoundsException 的常见原因" } ] }'如果返回类似下面的结构，说明请求成功：
{ "id": "msg_xxx", "type": "message", "role": "assistant", "content": [ { "type": "text", "text": "常见原因是游标未调用 moveToFirst() 或 moveToNext() 就执行 getString()，此时游标位置为 -1。" } ] }拿到这个返回，你就可以把 Android 崩溃日志、错误代码片段作为content发过去，让模型帮你定位。比如把CursorIndexOutOfBoundsException: Index -1 requested, with a size of 4这段堆栈贴进去，模型会直接指出游标没移动。验证通过后，再回到 Android 工程里逐个修下面的错误。
5. Android 高频错误逐项排查清单
这一节是全文的核心。每个错误都按“错误写法 → 崩溃/异常现象 → 正确写法 → 原因”的结构讲，你可以对照自己的代码逐条检查。
5.1 TextView 设置颜色传了资源 ID
错误写法：
TextView tv = findViewById(R.id.title); tv.setTextColor(R.color.white);这段代码编译完全没问题，因为R.color.white本身是int，setTextColor(int)也接收int。但运行后颜色不对，甚至显示成奇怪的颜色。原因是R.color.white是资源 ID，不是颜色值。正确写法：
tv.setTextColor(getResources().getColor(R.color.white));或者用ContextCompat：
tv.setTextColor(ContextCompat.getColor(this, R.color.white));这个错误的隐蔽性在于类型都是int，编译器不会报错。排查时搜索所有setTextColor(R.的写法，基本一抓一个准。
5.2 Cursor 未移动就取值
错误写法：
Cursor cursor = contentResolver.query(uri, null, null, null, null); if (cursor != null) { String name = cursor.getString(1); cursor.close(); }运行到cursor.getString(1)直接抛：
android.database.CursorIndexOutOfBoundsException: Index -1 requested, with a size of 4原因是查询返回的游标初始位置在 -1，也就是第一行之前，必须先移动。正确写法有两种。单行取值：
if (cursor != null) { if (cursor.moveToFirst()) { String name = cursor.getString(1); } cursor.close(); }多行遍历：
if (cursor != null) { while (cursor.moveToNext()) { String name = cursor.getString(1); } cursor.close(); }排查时重点看query之后有没有moveToFirst或moveToNext。另外cursor.close()要放在 finally 或 try-with-resources 里，避免异常时泄漏。
5.3 SQLite 查询条件漏掉空值
假设name字段类型是 TEXT，你想查name不等于zhangsan的记录，写了：
SELECT * FROM user WHERE name <> 'zhangsan';当某行name为 NULL 时，name <> 'zhangsan'的结果不是 true，而是 NULL，SQLite 会把它当 false 处理，这行记录就被过滤掉了。正确写法：
SELECT * FROM user WHERE name <> 'zhangsan' OR name IS NULL;除非你确实想排除空值记录，否则一定要加上OR name IS NULL。这个坑在数据量小的时候不容易发现，等线上数据里出现空值，查询结果对不上，排查起来很费时间。
5.4 Service 没在 AndroidManifest.xml 注册
启动 Service 的代码：
Intent service = new Intent(this, FuncService.class); startService(service);Service 没起来，日志里可能只有一句模糊的警告。原因往往是忘了在AndroidManifest.xml里注册：
<service android:name="com.android.example.FuncService" />排查时先确认 Manifest 里有没有对应的<service>节点，android:name是否和类全名一致。如果是 Android 8.0 以上，还要注意后台启动 Service 的限制，可能需要改用startForegroundService。
5.5 非 Activity Context 启动 Activity 缺 Flag
在 Application Context 或非 Activity 的 Context 里调用startActivity：
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); context.startActivity(intent);不加这个 Flag 会抛：
Calling startActivity() from outside of an Activity context requires the FLAG_ACTIVITY_NEW_TASK flag.更隐蔽的是系统控件的隐性调用。比如：
TextView tv = new TextView(mContext); tv.setAutoLinkMask(Linkify.ALL); tv.setText(content);当content里有电话、邮件、URL，且mContext是getApplicationContext()时，URLSpan.onClick内部会调startActivity，同样抛上面的异常。解决办法是传入 Activity 的 Context，而不是 Application Context。
5.6 单例对象持有 Context 导致 receiver leak
如果你在一个单实例对象里注册监听器，传进去的 Context 必须是ApplicationContext，否则会报 receiver leak。原因是单例生命周期比 Activity 长，持有 Activity Context 会导致 Activity 无法回收。排查时看单例的构造函数，把this换成getApplicationContext()。
5.7 控件布局参数设置顺序错误
想让 LinearLayout 充满屏幕，写了：
LinearLayout panel = new LinearLayout(this); LinearLayout.LayoutParams llp = new LinearLayout.LayoutParams( LinearLayout.LayoutParams.FILL_PARENT, LinearLayout.LayoutParams.FILL_PARENT); panel.setLayoutParams(llp); root.addView(panel);结果没充满。正确写法是把 LayoutParams 传给addView：
root.addView(panel, llp);原因是setLayoutParams在addView之前调用，可能被父容器的默认参数覆盖。排查时看addView有没有带第二个参数。
5.8 ListView 分割线设置顺序
mListView.setDivider(getResources().getDrawable(R.drawable.list_divider)); mListView.setDividerHeight(2);setDividerHeight必须在setDivider之后调用，否则分割线无效。顺序反了的话，高度设置会被重置。排查时看这两行的先后。
5.9 字符串资源里的空格被过滤
想在按钮上显示“删 除”，写了：
<string name="button_delete_text">删 除</string>结果中间空格看不到。原因是编译时会过滤普通空格。正确写法用 Unicode 转义：
<string name="button_delete_text">删\u0020除</string>其他特殊符号同理：'用\u0027，<用\u003C，>用\u003E。注意是十六进制。也可以用 XML 实体：'、<、>，数字是十进制，末尾分号不能少。
5.10 月份从 0 开始
final int old_month = calendar.get(Calendar.MONTH);Calendar.MONTH返回 0 到 11，0 代表一月。格式化时记得加 1：
String dateTimes = String.format("%04d-%02d-%02d", year, monthOfYear + 1, dayOfMonth);排查日期相关逻辑时，先看月份有没有加 1。
5.11 不要用 Deprecated 的类
比如android.telephony.gsm.SmsMessage已废弃，应该用android.telephony.SmsMessage。废弃类在不同协议下可能出问题。排查时看 IDE 的删除线警告，逐个替换。
5.12 断点不可信，日志更可靠
Eclipse 或 Android Studio 的断点遇到多线程、空语句时经常不走。别急着下结论说断点位置错了。每个工程都应该有日志开关，通过日志确认代码路径和变量值。排查时先加日志，再判断。
6. 本篇常见错排查
配置和代码都过了一遍，下面这些是实际操作中最容易卡住的地方。
请求返回 401 或 403：先确认TAOTOKEN_API_KEY环境变量有没有导出，echo $TAOTOKEN_API_KEY看有没有值。如果 Key 是从控制台复制的，注意有没有多余空格。再确认请求头里用的是x-api-key，不是Authorization。
请求返回 404：检查base_url有没有多写路径。正确是https://taotoken.net/api，后面接/v1/messages。不要写成https://taotoken.net/api/带尾斜杠，也不要漏掉/api。
Cursor 异常修了还崩：确认moveToFirst()的返回值有没有判断。如果查询结果为空，moveToFirst()返回 false，此时getString仍会崩。正确做法是if (cursor.moveToFirst())包住取值逻辑。
SQLite 查询结果还是不对：用adb shell进到数据库目录，直接执行 SQL 看结果。命令是sqlite3 /data/data/包名/databases/库名.db，然后跑你的查询语句。对比加OR name IS NULL前后的结果差异。
Service 注册了还是起不来：检查AndroidManifest.xml里<service>节点是不是写在<application>内部。写在外部无效。另外确认android:exported属性，Android 12 以上启动非 exported 的 Service 会受限。
Context 相关异常定位不到：在startActivity调用处加日志，打印context的类型。如果是Application类型，就要加FLAG_ACTIVITY_NEW_TASK或换成 Activity Context。对于URLSpan这种系统内部调用，只能从源头换 Context。
配置改了不生效：settings.json和config.toml如果同时存在，工具可能只读其中一个。确认你的工具链读的是哪份，把另一份删掉或改名。改完配置后重启工具进程，很多工具不会热加载配置。
模型返回内容被截断：检查max_tokens设置。排查 Android 崩溃日志时，堆栈可能很长，max_tokens设太小会导致返回不完整。建议至少 1024，复杂分析设 2048。
7. 把排查流程固定下来
Android 这些错误的共同点是编译器帮不上忙，只能靠运行时验证和代码审查。我的做法是把本文的检查清单固化成两个动作：一是提交代码前跑一遍check_rules里列的规则，重点看setTextColor、cursor.getString、name <>这几类写法；二是把崩溃日志通过 TaoToken 通道发给模型做归因，拿到初步结论后再人工确认。这样比纯靠肉眼 review 快很多。
如果你要长期做编码辅助和自动化排查，可以走 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。如果只是偶尔查一下代码问题，用模型对话入口就够了：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。接入参数和请求格式以文档为准：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。Key 管理和生成在控制台：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 和 API Keys 页面：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。把配置骨架复制过去，改一下 Key 环境变量，就能开始用了。
