Kotlin 协程阻塞 IO 超时修复
将以下提示词粘贴到你的 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/内网文件读且用户反馈「取消不了加载」的移动端开发者