Agent Skills
返回列表
Kotlin 协程阻塞 IO 超时修复

Kotlin 协程阻塞 IO 超时修复

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @chaoyutechnology/kotlin-blocking-io-timeout。

技能介绍

问题从哪来

在 Kotlin 协程里用 withTimeout(5000) { input.read(...) } 包一层阻塞式原生 IO——Socket 读、文件读、JDBC、Process、Samba 等——很常见。远端不回数据时,read() 会一直卡在 native 层;withTimeout 只是挂了取消标志,线程到不了挂起点,协程就永远不回来。用户侧往往是加载弹窗一直转、界面假死。

Dispatchers.IO 只能把阻塞挪出主线程,并不能让超时真正打断 native 里的 read()。

技能帮你做什么

技能给出一套经过实战验证的修复路径,而不是泛泛讲「记得用协程」。

  • 原因拆解:为什么 withTimeout 和 job.cancel() 对这类 IO 会失效。
  • 可落地的模板:把阻塞 IO 放到独立单线程线程池;用 Future.get(timeout) 等结果;超时或取消时强制关闭底层 socket/连接,让阻塞的 read() 抛异常退出、线程可回收。
  • 调用链约束:整条路径包在同一个 Future 提交里,避免嵌套提交导致死锁;取消按钮同样需要关底层资源,取消才会生效。
  • 自检清单:用来扫项目里是否还有同类写法。

适用边界

这套套路主要消除「协程永远挂起、超时/取消不生效」这一类卡死。若网络层、重试或业务状态机本身有设计问题,仍需结合具体代码一起看;技能面向有 Kotlin/Android 阻塞 IO 代码可贴出的场景。

使用场景

  • Android 播放器用协程拉网络流,远端断流后 `withTimeout` 无效、加载框一直转
  • Retrofit/Okio 底层 Socket 读在协程里阻塞,需要给请求做可靠超时与可取消
  • 文件或 Samba 读取包在 `withTimeout` 里,大文件或慢盘导致协程无法按时返回
  • JDBC 或子进程 `Process` 调用卡在 native,用户点取消后界面仍无响应

适合人员

  • 维护 Android 网络/媒体模块、需要把「5 秒超时」做成真超时而非假取消的客户端工程师
  • 在 Kotlin 后端或工具里用协程包 JDBC/进程调用、被生产环境卡死工单追着改的开发者
  • Code Review 时反复看到 `withTimeout { blockingRead() }`、想统一团队修复套路的技术负责人
  • 集成 Samba/内网文件读且用户反馈「取消不了加载」的移动端开发者