如何在asyncio中从信号处理程序捕获自定义异常？

Question

在使用asyncio时，从信号处理程序回调引发自定义异常时，我在捕获该异常时遇到问题

如果我从下面的do_io()中抛出ShutdownApp，我就能够在run_app()中正确地捕捉到它。然而，当从handle_sig()引发异常时，我似乎无法捕获它

Minimal, Reproducible Example使用Python 3.8.5进行测试：

import asyncio
from functools import partial
import os
import signal
from signal import Signals


class ShutdownApp(BaseException):
    pass


os.environ["PYTHONASYNCIODEBUG"] = "1"


class App:
    def __init__(self):
        self.loop = asyncio.get_event_loop()

    def _add_signal_handler(self, signal, handler):
        self.loop.add_signal_handler(signal, handler, signal)

    def setup_signals(self) -> None:
        self._add_signal_handler(signal.SIGINT, self.handle_sig)

    def handle_sig(self, signum):
        print(f"\npid: {os.getpid()}, Received signal: {Signals(signum).name}, raising error for exit")
        raise ShutdownApp("Exiting")

    async def do_io(self):
        print("io start. Press Ctrl+C now.")
        await asyncio.sleep(5)
        print("io end")

    def run_app(self):
        print("Starting Program")
        try:
            self.loop.run_until_complete(self.do_io())
        except ShutdownApp as e:
            print("ShutdownApp caught:", e)
            # TODO: do other shutdown related items
        except:
            print("Other error")
        finally:
            self.loop.close()


if __name__ == "__main__":
    my_app = App()
    my_app.setup_signals()
    my_app.run_app()
    print("Finished")

在异步调试模式下按CTRL+C（对于SIGINT）后的输出：

(env_aiohttp) anav@anav-pc:~/Downloads/test$ python test_asyncio_signal.py 
Starting Program
io start. Press Ctrl+C now.
^C
pid: 20359, Received signal: SIGINT, raising error for exit
Exception in callback App.handle_sig(<Signals.SIGINT: 2>)
handle: <Handle App.handle_sig(<Signals.SIGINT: 2>) created at /home/anav/miniconda3/envs/env_aiohttp/lib/python3.8/asyncio/unix_events.py:99>
source_traceback: Object created at (most recent call last):
  File "test_asyncio_signal.py", line 50, in <module>
    my_app.setup_signals()
  File "test_asyncio_signal.py", line 25, in setup_signals
    self._add_signal_handler(signal.SIGINT, self.handle_sig)
  File "test_asyncio_signal.py", line 22, in _add_signal_handler
    self.loop.add_signal_handler(signal, handler, signal)
  File "/home/anav/miniconda3/envs/env_aiohttp/lib/python3.8/asyncio/unix_events.py", line 99, in add_signal_handler
    handle = events.Handle(callback, args, self, None)
Traceback (most recent call last):
  File "/home/anav/miniconda3/envs/env_aiohttp/lib/python3.8/asyncio/events.py", line 81, in _run
    self._context.run(self._callback, *self._args)
  File "test_asyncio_signal.py", line 31, in handle_sig
    raise ShutdownApp("Exiting")
ShutdownApp: Exiting
io end
Finished

预期产出：

Starting Program
io start. Press Ctrl+C now.
^C
pid: 20359, Received signal: SIGINT, raising error for exit
ShutdownApp caught: Exiting
io end
Finished

是否可以从asyncio中的信号处理程序引发自定义异常？如果是这样，我如何正确地捕捉/排除它

Answer 1

如果我从下面的do_io（）中抛出ShutdownApp，我就能在run_app（）中正确捕获它。但是，当从handle_sig（）引发异常时，我似乎无法捕获它

对上述查询的响应

自定义异常实现：

class RecipeNotValidError(Exception):    
    def __init__(self):       
        self.message = "Your recipe is not valid"        
        try:            
            raise RecipeNotValidError
        except RecipeNotValidError as e:            
            print(e.message)

在handle_sig方法中，添加try和except块。此外，您还可以在自定义异常中自定义消息

 def handle_sig(self, signum):
        try:
            print(f"\npid: {os.getpid()}, Received signal: {Signals(signum).name}, raising 
                 error for exit")
            raise ShutdownApp("Exiting")
        except ShutdownApp as e:
            print(e.message)   

在回答您的第二个问题时： 是否可以在asyncio中从信号处理程序引发自定义异常？如果是这样，我如何正确地捕捉/排除它

异步IO中的内置错误处理。有关更多文档，请访问https://docs.python.org/3/library/asyncio-exceptions.html

import asyncio
async def f():
    try:
        while True: await asyncio.sleep(0)
    except asyncio.CancelledError:  
        print('I was cancelled!')  
    else:
        return 111

Answer 2

handle_sig是一个回调，因此它直接从事件循环运行，其异常只是通过全局钩子报告给用户。如果希望在程序中的其他地方捕获在那里引发的异常，则需要使用future将异常从handle_sig转移到希望注意的位置

要在顶层捕获异常，您可能需要引入另一种方法，我们称之为async_main()，它等待或者self.do_io()或者之前创建的未来完成：

    def __init__(self):
        self.loop = asyncio.get_event_loop()
        self.done_future = self.loop.create_future()

    async def async_main(self):
        # wait for do_io or done_future, whatever happens first
        io_task = asyncio.create_task(self.do_io())
        await asyncio.wait([self.done_future, io_task],
                           return_when=asyncio.FIRST_COMPLETED)
        if self.done_future.done():
            io_task.cancel()
            await self.done_future  # propagate the exception, if raised
        else:
            self.done_future.cancel()

要从handle_sig内部引发异常，只需在future对象上set the exception：

    def handle_sig(self, signum):
        print(f"\npid: {os.getpid()}, Received signal: {Signals(signum).name}, raising error for exit")
        self.done_future.set_exception(ShutdownApp("Exiting"))

最后，您修改run_app以将self.async_main()传递给run_until_complete，然后您就可以：

$ python3 x.py
Starting Program
io start. Press Ctrl+C now.
^C
pid: 2069230, Received signal: SIGINT, raising error for exit
ShutdownApp caught: Exiting
Finished

最后，请注意，可靠地捕获键盘中断是一个notoriously tricky undertaking问题，上面的代码可能不会涵盖所有的情况