1. Android 开发里那些“编译通过、运行崩溃”的坑Android 开发最让人头疼的不是写不出功能而是代码编译一路绿灯装到真机上却直接崩给你看。TextView 颜色设了没生效、Cursor 一取值就抛CursorIndexOutOfBoundsException、SQLite 查询条件漏掉空值判断导致数据对不上——这些问题在 Android 圈子里几乎每个开发者都踩过。它们有个共同特征类型系统帮不了你。setTextColor(R.color.white)传的是资源 ID编译器当它是合法的 intcursor.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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。它的作用是让你用一套 Key 和一套请求格式去调用不同的模型能力省掉每个服务单独配 Key、单独记 endpoint 的麻烦。对于 Android 团队来说比较实用的场景是把崩溃日志、CursorIndexOutOfBoundsException堆栈、SQLite 查询语句丢给模型做归因分析或者让模型帮你 review 一段setTextColor的写法有没有问题。你需要先拿到 API Key。进入控制台创建https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 然后在 API Keys 页面生成一个 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。Key 生成后只显示一次复制保存好。如果你更习惯在对话界面里直接贴代码问问题可以用模型对话入口https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果是要长期做编码辅助、Agent 自动排查可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节和参数说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。注意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你的Keyandroid_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_urlAPI 请求基址https://taotoken.net/apiapi_key_env读取 Key 的环境变量名TAOTOKEN_API_KEYdefault_model默认调用的模型按需选择timeout_seconds单次请求超时60max_retries失败重试次数2log_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本身是intsetTextColor(int)也接收int。但运行后颜色不对甚至显示成奇怪的颜色。原因是R.color.white是资源 ID不是颜色值。正确写法tv.setTextColor(getResources().getColor(R.color.white));或者用ContextCompattv.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而是 NULLSQLite 会把它当 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:namecom.android.example.FuncService /排查时先确认 Manifest 里有没有对应的service节点android:name是否和类全名一致。如果是 Android 8.0 以上还要注意后台启动 Service 的限制可能需要改用startForegroundService。5.5 非 Activity Context 启动 Activity 缺 Flag在 Application Context 或非 Activity 的 Context 里调用startActivityintent.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 传给addViewroot.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 namebutton_delete_text删 除/string结果中间空格看不到。原因是编译时会过滤普通空格。正确写法用 Unicode 转义string namebutton_delete_text删\u0020除/string其他特殊符号同理用\u0027用\u003C用\u003E。注意是十六进制。也可以用 XML 实体#39;、#60;、#62;数字是十进制末尾分号不能少。5.10 月份从 0 开始final int old_month calendar.get(Calendar.MONTH);Calendar.MONTH返回 0 到 110 代表一月。格式化时记得加 1String 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 Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。如果只是偶尔查一下代码问题用模型对话入口就够了https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。接入参数和请求格式以文档为准https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Key 管理和生成在控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 和 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。把配置骨架复制过去改一下 Key 环境变量就能开始用了。