Tornado常见报错问题及解决方案

1、RuntimeError: Cannot run the event loop while another loop is running

错误描述：这个错误通常出现在使用Tornado的HTTP客户端时，在Tornado 5.0以后的版本中，如果在IOLoop循环中直接使用了同步的HTTPclient，会触发这个错误。

原因分析：这是因为同步的HTTPClient会阻塞IOLoop的事件循环，导致无法同时运行多个事件循环。

解决方案：应使用异步的AsyncHTTPClient来替代同步的HTTPClient。

     import tornado.web
     import tornado.ioloop
     import tornado.httpclient
     from tornado.options import define, options
     define("port", default=8989, help="run on the given port", type=int)
     class IndexHandler(tornado.web.RequestHandler):
         async def get(self):
             client = tornado.httpclient.AsyncHTTPClient()
             response = await client.fetch("https://www.baidu.com")
             print(response.body)
             self.write("ok")
     if __name__ == '__main__':
         tornado.options.parse_command_line()
         app = tornado.web.Application(handlers=[(r"/", IndexHandler)], debug=True)
         http_server = tornado.httpserver.HTTPServer(app)
         http_server.listen(options.port)
         tornado.ioloop.IOLoop.instance().start()

2、NotImplementedError

错误描述：在使用Python 3.8及以上版本时，可能会遇到NotImplementedError错误，尤其是在Windows系统上。

原因分析：这是由于Python 3.8在Windows上默认使用ProactorEventLoop，而不是之前的SelectorEventLoop，Tornado需要使用SelectorEventLoop来处理异步IO操作。

解决方案：在Tornado开始执行前，添加以下代码来设置Windows系统使用SelectorEventLoop：

     import platform
     import asyncio
     if platform.system() == "Windows":
         asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())

3、OSError: [Errno 98] Address already in use

错误描述：在多进程启动Tornado服务器时，可能会出现地址已被占用的错误。

原因分析：这是由于端口号已经被其他进程占用，通常是因为之前的进程没有正确释放端口。

解决方案：确保在启动新的服务器实例之前，旧的服务器实例已经关闭并释放了端口，可以使用tryexcept块来捕获并处理这种错误：

     sockets = tornado.netutil.bind_sockets(options.port)
     try:
         tornado.process.fork_processes(0)
         server = tornado.httpserver.HTTPServer(app, xheaders=True)
         server.add_sockets(sockets)
         tornado.ioloop.IOLoop.instance().start()
     except OSError as e:
         if e.errno == 98:
             print("Address already in use, please check if the previous instance is still running.")

4、ImportError: No module named 'tornado'

错误描述：在PyCharm等IDE中导入Tornado模块时，可能会遇到未解决的引用错误。

原因分析：这可能是由于项目配置或环境变量设置不正确导致的。

解决方案：确保Tornado模块已安装，并在项目的设置中正确配置了Python解释器和PYTHONPATH，可以尝试以下步骤：

确保Tornado已安装：pip install tornado

在PyCharm中，右键点击项目目录，选择“Mark Directory as” > “Sources Root”。

检查PyCharm的设置，确保Python解释器路径和PYTHONPATH包含Tornado模块的位置。

相关FAQs

1、为什么在Tornado中使用同步HTTPClient会导致RuntimeError？

回答：在Tornado 5.0以后的版本中，IOLoop的事件循环不能被阻塞，同步的HTTPClient会阻塞事件循环，导致无法同时运行多个事件循环，从而引发RuntimeError，应使用异步的AsyncHTTPClient来替代。

2、如何在Windows系统上解决Tornado的NotImplementedError错误？

回答：在Tornado开始执行前，添加以下代码来设置Windows系统使用SelectorEventLoop：

     import platform
     import asyncio
     if platform.system() == "Windows":
         asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())