1. 问题现场点击列表就崩日志只给了一个 Boolean如果你正在用BaseAdapter给ListView填充数据运行起来列表显示正常滑动也顺滑结果手指一点某一项Logcat 立刻红字刷屏java.lang.ClassCastException: java.lang.Boolean cannot be cast to com.example.xxx.Bean更让人抓狂的是崩溃位置往往不在你写getItem()的那一行而是在onItemClick里做强制转换的那一行。你盯着代码看半天心想我明明返回的是实体对象怎么变成布尔值了这个问题的核心其实藏在BaseAdapter.getItem()的返回值里。很多教程在写BaseAdapter骨架时为了让Cursor能移动到指定位置顺手把getItem()写成了cursor.moveToPosition(position)。而moveToPosition()的返回值是boolean不是Cursor也不是你的实体类。于是ListView内部调用getItemAtPosition(position)时拿到的就是一个Boolean你在onItemClick里再强转成实体类自然就抛ClassCastException。这篇内容适合正在维护老 Android 项目、还在用ListView BaseAdapter的开发者也适合刚接手别人代码、被这个报错卡住的同学。我会从getItemViewType的返回值类型、convertView复用、点击回调参数传递三个角度拆根因然后给出一份可以直接复制的BaseAdapter骨架和onItemClick校验代码最后补上统一 Key/API 通道的config.toml配置片段与验证步骤目标是一次性消除这类类型转换崩溃。2. 根因拆解getItem 返回 Boolean 的三条路径2.1 getItem 被写成了 moveToPosition先看一段非常典型的错误写法Override public Object getItem(int position) { return cursor.moveToPosition(position); }Cursor.moveToPosition(int position)的签名是boolean moveToPosition(int position)它只告诉你“移动成功还是失败”并不返回游标本身。所以getItem()返回的是装箱后的Boolean。而ListView.getItemAtPosition(position)内部会调用Adapter.getItem(position)也就是说Object item listView.getItemAtPosition(position); // item 实际是 Boolean不是你的实体类当你在onItemClick里写Bean bean (Bean) listView.getItemAtPosition(position);JVM 发现运行时类型是Boolean目标类型是Bean直接抛ClassCastException: java.lang.Boolean。2.2 getItemViewType 返回值越界或类型混乱BaseAdapter里getItemViewType(int position)必须返回int并且取值范围是0到getViewTypeCount() - 1。如果你在getItemViewType里返回了-1或者返回了一个超过getViewTypeCount()的值ListView在复用convertView时会拿到类型不匹配的视图间接导致后续点击回调里参数错乱。更隐蔽的一种情况是getItemViewType和getItem的语义被混用。有人把getItemViewType当成“返回数据类型”来用返回了Boolean相关的判断结果虽然编译能过因为返回 int但逻辑上已经偏离了“视图类型”的本意。2.3 convertView 复用与点击位置错位ListView的convertView复用机制本身没问题但如果getItemViewType返回的类型和getView里实际创建的布局不一致就会出现“第 3 项复用了第 1 项的 View”这种情况。此时onItemClick里的position仍然是对的但如果你在onItemClick里通过view.getTag()去取数据就可能取到上一个位置的数据进而做出错误的类型转换。这三条路径的共同点是getItem()的返回值语义被破坏了。只要getItem()返回的不是你期望的数据对象onItemClick里的强转就一定会出问题。3. TaoToken 前置统一 Key 与 API 通道在修完这个崩溃之后如果你的项目还需要接入大模型能力比如做智能问答、代码补全或者 Agent 调度建议把 Key 和 API 通道统一管理避免每个模块各写一套配置。TaoToken 提供统一的 Key 和 API 入口官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。你可以先在控制台创建一个 Key然后把它写进项目的config.toml。这样做的好处是Android 端、后端服务、脚本工具可以共用同一套配置排查问题时只需要看一个文件。注意Key 属于敏感信息不要硬编码在Activity或Adapter里也不要提交到公开仓库。建议放在本地config.toml并通过.gitignore排除。4. 可复制配置BaseAdapter 骨架与 config.toml4.1 正确的 BaseAdapter 骨架下面这份骨架把getItem()的返回值修正为实体对象同时保留Cursor场景下的正确用法public class BeanAdapter extends BaseAdapter { private final ListBean data; private final LayoutInflater inflater; public BeanAdapter(Context context, ListBean data) { this.data data; this.inflater LayoutInflater.from(context); } Override public int getCount() { return data null ? 0 : data.size(); } Override public Bean getItem(int position) { if (data null || position 0 || position data.size()) { return null; } return data.get(position); } Override public long getItemId(int position) { return position; } Override public int getViewTypeCount() { return 1; } Override public int getItemViewType(int position) { return 0; } Override public View getView(int position, View convertView, ViewGroup parent) { ViewHolder holder; if (convertView null) { convertView inflater.inflate(R.layout.item_bean, parent, false); holder new ViewHolder(); holder.title convertView.findViewById(R.id.tv_title); convertView.setTag(holder); } else { holder (ViewHolder) convertView.getTag(); } Bean bean getItem(position); if (bean ! null) { holder.title.setText(bean.getTitle()); } return convertView; } static class ViewHolder { TextView title; } }如果你确实在用Cursor正确写法应该是让getItem()返回Cursor本身而不是moveToPosition的结果Override public Object getItem(int position) { if (cursor ! null cursor.moveToPosition(position)) { return cursor; } return null; }4.2 onItemClick 校验代码在onItemClick里不要直接强转先做类型判断listView.setOnItemClickListener(new AdapterView.OnItemClickListener() { Override public void onItemClick(AdapterView? parent, View view, int position, long id) { Object item parent.getItemAtPosition(position); if (item instanceof Bean) { Bean bean (Bean) item; Toast.makeText(MainActivity.this, bean.getTitle(), Toast.LENGTH_SHORT).show(); } else { Log.w(ListClick, unexpected item type: (item null ? null : item.getClass().getName())); } } });这段代码的关键是instanceof判断。即使getItem()被改错了也不会直接崩溃而是打出日志提醒你类型不对。4.3 config.toml 配置片段如果你要把 TaoToken 的 Key 和 API 地址统一管理可以在项目根目录建一个config.toml[taotoken] api_base https://taotoken.net/api api_key sk-你的Key model claude-sonnet timeout_seconds 30 [app] debug true log_level debug然后在代码里读取这个配置。Android 端可以用BuildConfig注入后端服务可以直接用 TOML 解析库加载。5. 验证请求与成功结果5.1 验证 ListView 点击不再崩溃把上面的BeanAdapter和onItemClick替换进项目重新运行。点击列表项时Logcat 应该输出正常的标题而不是ClassCastException。如果你故意把getItem()改回cursor.moveToPosition(position)再点击应该看到unexpected item type: java.lang.Boolean的警告日志而不是崩溃。5.2 验证 TaoToken API 通道配置好config.toml后可以用 curl 验证 API 通道是否可用curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: claude-sonnet, messages: [{role: user, content: 你好}] }如果返回正常的 JSON 响应说明 Key 和 API 地址配置正确。如果返回 401检查 Key 是否复制完整如果返回 404检查api_base是否写成了https://taotoken.net/api。5.3 验证 getItemViewType 边界写一个简单的单元测试或者直接在getItemViewType里加日志Override public int getItemViewType(int position) { int type 0; Log.d(Adapter, position position , type type); return type; }确保返回的type始终在0到getViewTypeCount() - 1之间。如果getViewTypeCount()返回 1getItemViewType就只能返回 0。6. 本篇常见错排查6.1 为什么改成 List 之后还是崩如果你把Cursor换成了List但getItem()里仍然写了return data.get(position) null;这种布尔表达式返回值依然是Boolean。检查getItem()的返回语句确保返回的是实体对象。6.2 getItemViewType 返回 -1 会怎样ListView在复用convertView时会根据getItemViewType的值去查找对应的视图类型。返回-1会导致类型查找失败可能表现为列表项显示错乱或者点击时position和实际数据对不上。把返回值限制在合法范围内即可。6.3 onItemClick 里用 view.getTag 取数据有些项目在getView里把实体对象存进view.setTag(bean)然后在onItemClick里用view.getTag()取。这种做法在convertView复用时容易取到旧数据。更稳妥的方式是直接用parent.getItemAtPosition(position)并配合instanceof判断。6.4 混淆配置导致 Boolean 强转失败如果你开启了 R8 或 ProGuard实体类被混淆后instanceof判断可能失效。检查混淆规则确保实体类不被混淆-keep class com.example.bean.** { *; }6.5 config.toml 读取不到 KeyAndroid 端读取本地文件时注意路径问题。config.toml放在assets目录下需要用AssetManager读取放在res/raw下需要用Resources.openRawResource()读取。如果直接写绝对路径在真机上可能没有权限。7. 语义一致 CTA修完ClassCastException: java.lang.Boolean之后如果你还想继续排查接入层的问题可以先去 API Keys 页面确认 Key 状态再对照接入文档检查config.toml里的api_base和model字段。需要验证模型返回是否符合预期时可以直接在模型对话里发一条测试消息。如果你正在做长期编码或 Agent 调度建议看一下 Coding Plan把 Key 管理和调用配额统一起来。API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后留一个我踩过的坑getItem()的返回值类型最好和onItemClick里强转的类型保持一致并且在onItemClick里永远先做instanceof判断。这样即使 Adapter 被改错也只是日志警告不会让用户看到崩溃弹窗。
