[E 2025-04-24 01:00:32.875 ServerApp] Uncaught exception GET /aext_core_server/feature_flag/init?1745427632534 (::1) HTTPServerRequest(protocol='http', host='localhost:8888', method='GET', uri='/aext_core_server/feature_flag/init?1745427632534', version='HTTP/1.1', remote_ip='::1') Traceback (most recent call last): File "D:\anaconda\Lib\site-packages\tornado\web.py", line 1790, in _execute result = await result ^^^^^^^^^^^^ File "D:\anaconda\Lib\site-packages\aext_core_server\handlers.py", line 29, in get [account, organizations, account_notebooks] = await asyncio.gather( ^^^^^^^^^^^^^^^^^^^^^ File "D:\anaconda\Lib\site-packages\aext_shared\handler.py", line 132, in anaconda_cloud_proxy user_access_credentials = await self.get_user_access_credentials(auth_optional=auth_optional) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

### Jupyter Server 扩展应用输入位置及未捕获异常处理方法 #### 一、Jupyter Server 扩展的应用输入位置 为了实现 Jupyter Server 的扩展功能，需定义 `_jupyter_server_extension_points` 函数。此函数应在 Python 模块中声明，具体来说可以位于以下两种常见场景之一： 1. 如果是小型扩展或单独的工具包，则可直接将该函数写入模块的 `__init__.py` 文件中。 2. 对于更复杂的项目结构，推荐创建一个专门用于管理扩展点的子模块，在其中定义 `_jupyter_server_extension_points` 并返回相应的字典列表[^1]。 下面展示了一个标准的例子，假设我们有一个名为 `my_jupyter_ext` 的扩展包： ```python # my_jupyter_ext/__init__.py def _jupyter_server_extension_points(): return [{"module": "my_jupyter_ext.extension"}] ``` 这里 `"my_jupyter_ext.extension"` 是指向实际实现扩展逻辑的具体模块名称。 --- #### 二、Tornado Web HTTPServer 请求中的异常追踪机制 针对 Tornado Web 应用程序可能出现的未捕获异常情况，可以通过重载 RequestHandler 类的方式来自定义错误响应行为。这样不仅可以记录详细的日志信息以便后续分析，还可以向客户端提供更加友好的反馈页面。 ##### 自定义 Base Handler 实现全局异常捕捉 通过继承 `tornado.web.RequestHandler` 创建基础处理器类，并覆盖其默认的 `write_error` 方法来定制化错误显示界面以及增强调试能力。 ```python import logging import tornado.web class BaseHandler(tornado.web.RequestHandler): def write_error(self, status_code, **kwargs): """Override to implement custom error pages.""" exc_info = kwargs.get("exc_info") if exc_info: log_message = f"Uncaught exception {status_code}: {exc_info}" logging.error(log_message) self.set_header('Content-Type', 'text/plain') if status_code == 404: self.write(f"{status_code} Not Found\n") elif status_code == 500: self.write(f"{status_code} Internal Server Error\nDetails: See logs.") else: self.write(f"{status_code}\n") ``` 随后所有的业务 handler 均应基于这个基类派生而出，从而统一整个系统的错误报告策略[^2]。 --- #### 三、配置 Jupyter Notebook Server 参数优化稳定性 除了调整代码层面外，合理设置 Jupyter Notebook server 启动参数同样有助于减少运行期间发生意外崩溃的概率。例如关闭浏览器自动打开选项 (`open_browser=False`) ，允许 root 用户权限操作(`allow_root=True`) 等等均能提升安全性与兼容性表现[^3]。 示例配置如下所示： ```python c.ServerApp.open_browser = False c.ServerApp.root_dir = '/path/to/your/workdir' c.ServerApp.allow_root = True c.ServerApp.allow_remote_access = True c.ServerApp.ip = '0.0.0.0' c.ServerApp.port = 9999 ``` 上述设定可通过修改用户的 `.jupyter/jupyter_notebook_config.py` 文件完成持久保存。 --- ###