Jupyter中MATLAB运行超5分钟内核断开问题排查与解决

问题根源 #

• 排除Jupyter本身：Jupyter Notebook/Lab默认没有强制5分钟的执行超时限制，你已排查过相关设置，所以可以排除Jupyter的问题。
• 锁定MATLAB扩展：问题出在MATLAB R2021b对应的Jupyter内核（matlab_kernel）上——这个内核内置了守护进程超时机制，默认5分钟，一旦代码单元运行超时就会主动断开内核连接。

解决方法 #

1. 修改内核配置文件设置超时时长 #

• 先找到MATLAB内核的安装路径：在终端执行jupyter kernelspec list，找到matlab对应的路径（比如~/miniconda3/envs/py38/share/jupyter/kernels/matlab）。
• 打开该路径下的kernel.json文件，在argv数组末尾添加--timeout=3600（3600秒=1小时，可根据需求调整数值），修改后示例：

  {
   "argv": [
    "python",
    "-m",
    "matlab_kernel",
    "-f",
    "{connection_file}",
    "--timeout=3600"
   ],
   "display_name": "MATLAB",
   "language": "matlab"
  }
  

• 保存文件后，重启Jupyter Notebook/Lab即可生效。

2. 直接禁用内核的超时检查（进阶方案） #

• 如果修改配置文件无效，找到matlab_kernel的Python包目录：终端执行pip show matlab_kernel获取安装路径（比如~/miniconda3/envs/py38/lib/python3.8/site-packages/matlab_kernel）。
• 编辑该目录下的kernel.py文件，找到超时相关代码：
  找到类似self.timeout = self.parent.config.get('matlab_kernel', {}).get('timeout', 300)的行，把300改成你需要的超大值（比如86400即24小时），或者直接注释掉后续基于self.timeout的断开逻辑。
• 保存文件后重启Jupyter。

3. 验证修改效果 #

• 运行测试代码确认：

  tic;
  pause(310); % 运行310秒，超过默认5分钟阈值
  toc;
  

  如果内核未断开且正常输出计时结果，说明修改成功。

内容的提问来源于stack exchange，提问作者Barry G