OnmyojiAutoScript中WebSocket连接异常问题分析与解决
项目地址: https://gitcode.com/gh_mirrors/on/OnmyojiAutoScript 问题现象
在使用OnmyojiAutoScript进行自动化游戏操作时，系统日志中频繁出现"Unexpected ASGI message 'websocket.send', after sending 'websocket.close'"的错误信息。该错误表现为WebSocket连接在关闭后仍然尝试发送消息，导致操作过程中出现异常。
技术背景
OnmyojiAutoScript是一个基于Python的阴阳师自动化脚本工具，它通过WebSocket协议与前端界面(OASX)进行通信。ASGI(Asynchronous Server Gateway Interface)是Python异步Web服务器和应用程序之间的标准接口，用于处理WebSocket等异步协议。
问题分析
-
连接状态不一致：当OASX与主程序之间的WebSocket连接断开后，主程序仍在尝试通过该连接发送消息。
-
消息队列处理异常：即使在连接关闭后，消息队列中可能仍有未处理的消息被尝试发送。
-
长时间运行问题：随着脚本运行时间增长，OASX的日志缓存可能出现堆积，导致无法正常接收新消息。
-
双任务冲突：当用户尝试重新启动OASX时，前一个任务可能未完全终止，导致两个任务实例同时操作同一界面。
解决方案
-
连接状态检查机制：
- 在发送任何WebSocket消息前，先检查连接状态
- 实现自动重连机制，当检测到连接断开时尝试重新建立连接
-
消息队列优化：
- 实现消息确认机制，确保每条消息都被正确接收
- 设置消息过期时间，避免堆积旧消息
-
资源管理改进：
- 增加心跳检测机制，定期检查连接健康状况
- 实现优雅关闭流程，确保所有资源被正确释放
-
用户操作建议：
- 避免在脚本运行过程中频繁重启OASX
- 定期检查系统资源使用情况
- 对于长时间运行的任务，考虑设置合理的休息间隔
实现细节
开发者已在代码提交c88465e中针对此问题进行了修复，主要改进包括：
- 增强WebSocket连接状态管理
- 优化消息发送逻辑，增加错误处理
- 完善连接断开后的清理流程
最佳实践
对于普通用户，建议采取以下措施避免此问题：
- 保持OnmyojiAutoScript及其依赖组件为最新版本
- 合理安排自动化任务的执行时间，避免单次运行时间过长
- 监控系统日志，及时发现并处理异常情况
- 按照官方文档正确配置和使用工具
总结
WebSocket连接异常是分布式系统中常见的问题，OnmyojiAutoScript通过增强连接状态管理和消息处理机制，有效解决了这一问题。用户只需保持软件更新并遵循最佳实践，即可获得稳定的自动化体验。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
