1. ListView 点击事件三种写法与 401 调试场景Android ListView 点击事件三种方式是很多做安卓开发的朋友绕不开的基础功AdapterView.OnItemClickListener 外部监听、Adapter 内部 getView 绑定、Activity 实现接口。这三种写法本身不难难的是点击之后触发的网络请求在本地调试时突然返回 401日志里只有一行HTTP 401 Unauthorized你分不清是 Key 没带上、Header 拼错了还是 endpoint 根本打到了错误的地址。这篇就把这两件事串起来讲先把三种点击事件的可复制代码写清楚再把请求链路统一收口到 TaoToken 的 Key 与 API 通道上用日志对照的方式定位 401。适合谁看刚接触 ListView 的安卓初学者、正在把本地接口切到统一网关的移动端开发者、以及被 401 卡住但不想盲改代码的人。核心检索词就是 ListView 点击事件与 401 排查全文围绕这两条线展开。先说清楚三种方式的本质差别后面调试才不会乱。它们最终都调用parent.getItemAtPosition(position)但返回值类型完全不同BaseAdapter 返回你自定义的实体对象SimpleAdapter 返回MapString,ObjectSimpleCursorAdapter 返回Cursor。很多人 401 排查到一半发现点击回调压根没进就是因为强转类型写错导致运行时崩溃日志被异常刷掉误以为是网络问题。我试过在同一个 Demo 里把三种方式都实现一遍然后统一在点击回调里发一个请求这样对比起来最直观。下面按「先写点击、再接网络、再排 401」的顺序走每一步都给可复制的片段。2. TaoToken 前置准备统一 Key 与 API 通道在动手改 endpoint 之前先把 TaoToken 这一层准备好。它的作用是给你的请求提供一个统一的 Key 和 API 通道这样本地调试时不用在多个接口地址之间来回切换401 的成因也能收敛到「Key 是否正确、Header 是否规范」这两点上。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个不加 UTM。你需要拿到两样东西一个 API Key以及确认要调用的 Model ID。Key 在控制台的 API Keys 页面创建地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keys_ctautm_campaignrewrite 。创建后立刻复制保存页面刷新后通常不再完整显示。Model ID 则在你打算调用的模型说明里比如对话类、编码类各有对应的标识接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdoc_ctautm_campaignrewrite 。这里有个容易踩的坑很多人把 Key 直接硬编码进MainActivity然后 git 提交上去回头 Key 泄露了又得重新建。建议放在local.properties或BuildConfig里通过 Gradle 注入。下面是一个build.gradleapp 模块的片段把 Key 和 Base URL 都做成可配置项android { defaultConfig { buildConfigField String, TAOTOKEN_BASE_URL, \https://taotoken.net/api\ buildConfigField String, TAOTOKEN_API_KEY, \${project.findProperty(TAOTOKEN_API_KEY) ?: }\ buildConfigField String, TAOTOKEN_MODEL_ID, \你的模型ID\ } }然后在gradle.properties不要提交到仓库里写TAOTOKEN_API_KEYsk-你的真实Key这样代码里用BuildConfig.TAOTOKEN_API_KEY就能取到切换环境只改一处。如果你用的是 Claude Code 这类编码工具做辅助开发接入方式在 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode_ctautm_campaignrewrite 思路是一样的Base URL、Key、Model ID 三件套齐全缺一个就会 401 或 404。前置准备做完你手上应该有三样确定的东西Base URL 是https://taotoken.net/api一个可用的 Key一个明确的 Model ID。接下来才进入点击事件和请求代码。3. 三种点击事件的可复制配置与请求收口这一节是全文的技术主体。三种点击事件分别给完整片段然后在每种方式的回调里统一调用一个sendRequest()方法把 endpoint 指向 TaoToken。这样点击行为和网络请求解耦401 排查时只看sendRequest()一处即可。3.1 方式一AdapterView.OnItemClickListener 外部监听这是最常见的写法在 Activity 或 Fragment 里给 ListView 设置监听器。先定义实体和 Adapterpublic class Person { private String name; private int balance; public Person(String name, int balance) { this.name name; this.balance balance; } public String getName() { return name; } public int getBalance() { return balance; } }BaseAdapter 的getView正常写这里不展开。关键是监听器personLV.setOnItemClickListener(new AdapterView.OnItemClickListener() { Override public void onItemClick(AdapterView? parent, View view, int position, long id) { Person p (Person) parent.getItemAtPosition(position); Toast.makeText(getApplicationContext(), p.getName(), Toast.LENGTH_SHORT).show(); sendRequest(p.getName()); } });注意parent.getItemAtPosition(position)返回的是Object这里强转成Person。如果你 Adapter 的getItem返回的不是 Person这行会抛ClassCastException日志里看不到 401只看到崩溃。这是排查顺序上的第一个分叉点。3.2 方式二Adapter 内部 getView 绑定点击这种方式把点击逻辑写进 Adapter 的getView适合每个 item 点击行为不一致的场景。片段如下Override public View getView(int position, View convertView, ViewGroup parent) { ViewHolder holder; if (convertView null) { convertView LayoutInflater.from(parent.getContext()) .inflate(R.layout.item_person, parent, false); holder new ViewHolder(); holder.nameTv convertView.findViewById(R.id.tv_name); convertView.setTag(holder); } else { holder (ViewHolder) convertView.getTag(); } Person p getItem(position); holder.nameTv.setText(p.getName()); convertView.setOnClickListener(v - { Toast.makeText(v.getContext(), p.getName(), Toast.LENGTH_SHORT).show(); sendRequest(p.getName()); }); return convertView; }这里有个细节convertView.setOnClickListener每次getView都会重新设置复用机制下不会错位因为闭包捕获的是当前position对应的p。但如果你在getView里做异步请求且没做防抖快速滑动会触发多次请求日志里出现重复的 401容易误判成 Key 失效。3.3 方式三Activity 实现 OnItemClickListener 接口这种方式让 Activity 本身实现接口代码更集中public class MainActivity extends AppCompatActivity implements AdapterView.OnItemClickListener { Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); ListView personLV findViewById(R.id.lv_person); personLV.setAdapter(new PersonAdapter(this, dataList)); personLV.setOnItemClickListener(this); } Override public void onItemClick(AdapterView? parent, View view, int position, long id) { Person p (Person) parent.getItemAtPosition(position); Toast.makeText(getApplicationContext(), p.getName(), Toast.LENGTH_SHORT).show(); sendRequest(p.getName()); } }三种方式到这里都齐了。它们的差别确实就在getItemAtPosition的返回值方式一和方式三拿到的是实体方式二在 Adapter 内部直接getItem(position)。如果你用的是 SimpleAdapter返回值是Map取值要写map.get(balance)用 SimpleCursorAdapter 则是Cursor要写c.getString(1)。类型对不上点击回调就进不去更别提 401 了。3.4 统一请求方法endpoint 指向 TaoToken三种点击最终都调sendRequest()。用 OkHttp 写一个最小实现private final OkHttpClient client new OkHttpClient(); private void sendRequest(String keyword) { MediaType JSON MediaType.parse(application/json; charsetutf-8); String body {\model\:\ BuildConfig.TAOTOKEN_MODEL_ID \, \messages\:[{\role\:\user\,\content\:\ keyword \}]}; Request request new Request.Builder() .url(BuildConfig.TAOTOKEN_BASE_URL /v1/chat/completions) .addHeader(Authorization, Bearer BuildConfig.TAOTOKEN_API_KEY) .addHeader(Content-Type, application/json) .post(RequestBody.create(body, JSON)) .build(); client.newCall(request).enqueue(new Callback() { Override public void onFailure(Call call, IOException e) { Log.e(TAOTOKEN, request failed: e.getMessage()); } Override public void onResponse(Call call, Response response) throws IOException { String resp response.body() ! null ? response.body().string() : ; Log.d(TAOTOKEN, code response.code() body resp); } }); }这里 Base URL 和 Key 都来自BuildConfigModel ID 也是。三件套齐全请求才会被正确路由。如果你把 Base URL 写成https://taotoken.net/api/末尾多斜杠再拼/v1/...可能出现双斜杠部分网关会返回 404 而不是 401日志要看清 code。4. 验证请求与成功结果对照代码写完先别急着点 item。用 curl 在命令行验证一次确认 Key 和 endpoint 本身没问题再去跑 App。这样能把「网络层问题」和「UI 层问题」分开。curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: ping}] }成功时你会看到类似{choices:[{message:{role:assistant,content:...}}]}的返回HTTP 状态码 200。如果这里就 401说明 Key 或 Header 有问题跟 ListView 无关先解决这一层。命令行通了之后跑 App点击任意 itemLogcat 过滤TAOTOKEN标签。正常日志长这样D/TAOTOKEN: code200 body{choices:[{message:{role:assistant,content:...}}]}对照关系很清晰curl 200 App 200链路通curl 200 App 401问题在 App 的 Header 或 Key 注入curl 401 App 401问题在 Key 本身或账户状态。这个对照表能帮你快速缩小范围。如果你更想先在网页上验证模型是否可用可以直接用模型对话页面发一条消息地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodels_ctautm_campaignrewrite 。网页能通、curl 能通、App 不通那基本锁定在客户端代码。5. 本篇常见错误排查这一节按真实报错来对。401 只是表象下面几种情况都会表现为请求失败日志关键词不同处理方式也不同。第一种HTTP 401 Unauthorizedbody 里常带invalid api key或missing authorization。原因通常是 Key 没注入成功BuildConfig.TAOTOKEN_API_KEY是空字符串Header 变成Bearer。检查gradle.properties是否被读取以及是否在正确的 build variant 下。三件套里 Key 缺失是最常见的。第二种local proxy failed或连接被拒绝。这类多半是本地网络环境或客户端代理配置导致请求没出去跟 Key 无关。先确认 curl 在同一台机器上能否通能通就说明是 App 侧的网络配置问题检查是否误设了代理。第三种日志里出现reading choices相关解析异常比如Expected BEGIN_OBJECT but was STRING。这通常是你用 Gson 解析返回体但返回的其实是错误结构比如 401 的 JSON 里没有choices字段。先打印原始 body再决定解析逻辑别直接fromJson。第四种OAuth 或鉴权流程相关报错比如OAuth token expired。如果你用的是带 OAuth 的接入方式Key 和 token 是两回事过期要重新获取。普通 API Key 方式不会出现这个。第五种点击没反应日志里连TAOTOKEN都没有。回到第 3 节检查getItemAtPosition的强转类型是否匹配你的 Adapter。类型错了会抛异常回调根本没执行到sendRequest()。排查顺序建议固定下来先看点击回调有没有进有没有 Toast再看sendRequest有没有被调用有没有 request 日志再看 HTTP code最后看 body。这个顺序能避免你在 UI 层和网络层之间反复横跳。6. 把调试链路固定下来的做法三种点击事件写完之后真正省时间的做法是把请求收口到一个方法、把配置收口到BuildConfig、把验证收口到 curl 加 Logcat 对照。这样下次再遇到 401你不需要重新读一遍 Adapter 代码直接按「curl 通不通 → App 日志 code → body 内容」三步走。如果你后续要做的是长期编码或 Agent 类任务可以把 Key 和通道的管理放到 Coding Plan 里统一处理入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcodingplan_ctautm_campaignrewrite 思路和这篇一致Base URL、Key、Model ID 三件套先对齐再谈业务逻辑。日常需要快速验证模型返回时模型对话页面和 API Keys 页面配合使用就够了。把这篇的sendRequest()留着换成你自己的业务参数点击事件的三种写法不用再重写。