
# NoneBot.exception 模块
# 异常
下列文档中的异常是所有 NoneBot 运行时可能会抛出的。 这些异常并非所有需要用户处理,在 NoneBot 内部运行时被捕获,并进行对应操作。
# exception IgnoredException
基类:Exception
说明
指示 NoneBot 应该忽略该事件。可由 PreProcessor 抛出。
参数
reason
: 忽略事件的原因
# exception PausedException
基类:Exception
说明
指示 NoneBot 结束当前
Handler
并等待下一条消息后继续下一个Handler
。 可用于用户输入新信息。用法
可以在
Handler
中通过Matcher.pause()
抛出。
# exception RejectedException
基类:Exception
说明
指示 NoneBot 结束当前
Handler
并等待下一条消息后重新运行当前Handler
。 可用于用户重新输入。用法
可以在
Handler
中通过Matcher.reject()
抛出。
# exception FinishedException
基类:Exception
说明
指示 NoneBot 结束当前
Handler
且后续Handler
不再被运行。 可用于结束用户会话。用法
可以在
Handler
中通过Matcher.finish()
抛出。
# exception StopPropagation
基类:Exception
说明
指示 NoneBot 终止事件向下层传播。
用法
在
Matcher.block == True
时抛出。
# exception RequestDenied
基类:Exception
说明
Bot 连接请求不合法。
参数
status_code: int
: HTTP 状态码reason: str
: 拒绝原因
# exception ApiNotAvailable
基类:Exception
说明
在 API 连接不可用时抛出。
# exception NetworkError
基类:Exception
说明
在网络出现问题时抛出,如: API 请求地址不正确, API 请求无返回或返回状态非正常等。
# exception ActionFailed
基类:Exception
说明
API 请求成功返回数据,但 API 操作失败。
参数
retcode: Optional[int]
: 错误代码