AtomVM项目中ESP32网络模块重启问题的分析与修复

问题背景

在AtomVM项目的ESP32平台上，开发人员发现了一个关于网络模块的重要问题。当使用network:stop/0函数停止网络后，尝试重新启动网络会导致虚拟机(VM)崩溃。这个问题影响了AtomVM的主分支(main)和0.6版本分支(release-0.6)。

问题现象

开发人员提供了一个测试用例来重现这个问题。测试流程如下：

1. 首先启动网络连接并等待连接建立
2. 然后停止网络以测试重启功能
3. 最后尝试重新启动网络连接

在执行第三步时，系统会触发一个硬崩溃，产生以下关键错误信息：

ESP_ERROR_CHECK failed: esp_err_t 0x103 (ESP_ERR_INVALID_STATE)
file: "/IDF/components/esp_wifi/src/wifi_default.c" line 390
func: esp_netif_create_default_wifi_sta
expression: esp_wifi_set_default_wifi_sta_handlers()

技术分析

根本原因

经过深入分析，发现这个问题主要由两个技术缺陷导致：

1. 事件处理程序未完全注销：当网络驱动停止时，并非所有的事件处理程序都被正确注销。这导致在尝试重新启动网络时，系统状态不一致。

2. 默认事件循环被错误删除：在stop_network函数(network_driver.c中)中，代码错误地删除了默认事件循环。这是一个严重问题，因为默认事件循环可能被系统中其他组件共享使用，而不仅仅是网络驱动。

影响范围

这个问题会影响所有依赖网络重启功能的ESP32应用程序。特别是在需要临时断开网络连接后又需要重新连接的场景下，如：

• 网络配置变更后的重连
• 节能模式下的间歇性连接
• 故障恢复机制

解决方案

修复方案针对上述两个问题分别进行了处理：

1. 完善事件处理程序注销：确保在停止网络时，所有相关的事件处理程序都被正确注销，为后续的重新启动做好准备。

2. 保护默认事件循环：修改stop_network函数的实现，避免删除可能被共享的默认事件循环，从而保持系统其他功能的稳定性。

修复验证

修复后的代码已经过测试验证，确认可以：

• 正常停止网络连接
• 成功重新启动网络连接
• 不会导致虚拟机崩溃
• 不影响系统其他功能的正常运行

技术建议

对于使用AtomVM网络模块的开发者，建议：

1. 如果应用中需要网络重启功能，应尽快升级到包含此修复的版本。

2. 在网络操作中加入适当的延迟，特别是在停止后立即重启的场景下，以确保系统状态完全重置。

3. 实现健壮的错误处理机制，特别是在网络不稳定的环境中。

这个修复不仅解决了网络重启的问题，还提高了整个网络模块的稳定性和可靠性，为ESP32上的AtomVM应用提供了更坚实的基础设施支持。