本章节介绍调试网络层的方法。
可通过 JVM 环境变量改变网络层的行为。一般用户通常不需要手动变更这些功能。
| 环境变量名称 | 可选值 | 解释 |
|---|---|---|
mirai.network.handler.selector.max.attempts |
[1, 2147483647] |
最大重连尝试次数 |
mirai.network.reconnect.delay |
[0, 9223372036854775807] |
两次重连尝试的间隔毫秒数 |
mirai.network.handle.selector.logging |
true/false |
启用执行重连时的详细日志 |
mirai.network.state.observer.logging |
true/on/false/off/full |
启用网络层状态变更的日志 |
mirai.event.launch.undispatched |
true/false |
详见 源码内注释 |
mirai.resource.creation.stack.enabled |
true/false |
启用 ExternalResource 创建时的 stacktrace 记录 (影响性能), 在资源泄露时展示 |
mirai.unknown.image.type.logging |
true/false |
启用遇到未知图片格式时的日志 |
mirai.network.show.all.components |
true/false |
在网络层异常中附加当前所有组件 (components) 内容 |
mirai.network.show.components.creation.stacktrace |
true/false |
在网络层异常中附加当前组件容器创建时的 stacktrace |
mirai.network.packet.logger |
true/false |
启用数据包日志 (将为展示所有接收的数据包的 id, sequenceId, extraData 以及内容 hex) |
mirai.network.show.verbose.packets |
true/false |
在日志记录数据包时包含冗长的数据包 (如 MessageSvc.PbGetMsg, OnlinePush.ReqPush, StatSvc.SimpleGet) |
mirai.network.show.packet.details |
true/false |
在日志记录数据包时包含 mirai 解析结果 |
mirai.event.show.verbose.events |
true/false |
在日志记录事件时包含冗长的事件 (如 GroupMessagePreSendEvent, GroupMessagePostSendEvent) |
修改示例：
在启动 JVM 时添加参数 -Dmirai.network.handle.selector.logging=true 则启用执行重连时的详细日志