Marzban项目中用户周期性用量重置后未自动启用的Bug分析

问题现象

在Marzban代理管理系统中，存在一个关于用户周期性用量重置后状态更新的问题。当用户达到周期性使用限制时，系统会按预期禁用用户对服务器的访问权限。然而，在周期性用量重置后（即用户用量计数器归零时），系统有时未能自动重新启用用户访问权限。

技术细节

这个Bug表现为：

1. 用户用量达到限额后被正确禁用
2. 系统执行周期性用量重置操作，用量计数器归零
3. 但用户状态未被更新，仍然保持禁用状态
4. 用户连接时仍会立即收到EOF错误

临时解决方案

目前发现两种临时解决方法：

1. 通过管理面板手动编辑并保存用户信息（无需实际修改任何设置）
2. 重启Marzban核心服务

对于生产环境，可以设置定时任务通过API自动重启核心服务。示例脚本使用curl和jq工具通过Marzban API获取管理员令牌，然后调用核心重启接口。

影响范围

该问题自Marzban 4.9版本开始存在，至少延续到5.2版本，甚至在最新的0.7.0版本中仍有报告。问题发生没有明显规律，属于间歇性出现。

技术分析

从现象判断，这很可能是一个状态同步问题。可能的根本原因包括：

1. 用量重置操作未正确触发状态重新评估
2. 状态缓存未及时更新
3. 事件处理链中存在遗漏

重启服务能解决问题表明可能与内存中的状态缓存有关，而手动编辑用户能解决问题则说明存在状态评估触发的遗漏。

建议

对于系统管理员：

1. 可以实施监控脚本定期检查用户状态
2. 在用量重置时间点后安排核心服务重启
3. 考虑在业务低峰期安排定期维护重启

对于开发者：

1. 需要检查用量重置与状态评估的代码路径
2. 验证状态缓存更新机制
3. 确保所有可能影响用户状态的操作都能正确触发状态重新计算

这个问题虽然不影响核心功能，但会影响用户体验，特别是对于严格按照用量周期运营的服务场景。