SSH连接AWS EC2 Jupyter执行.py时matplotlib交互图失效及报错问题

报错与交互失效的核心根因 #

• 环境上下文隔离：使用!python filename.py启动的是独立于Jupyter内核的全新Python子进程，不会继承当前Notebook已经激活的%matplotlib notebook交互后端配置，默认使用无交互的Agg后端渲染输出，无法建立浏览器端的matplotlib交互通道，自然无法触发onClick回调
• 全局状态覆盖：很多外部py文件为适配服务器端无界面运行场景，会在文件开头硬编码matplotlib.use('Agg')这类后端设置，执行%run加载脚本时会直接覆盖当前Notebook的交互后端配置，强制切回无交互渲染模式
• 对象生命周期回收：脚本运行结束后，如果创建的Figure、Axes对象、回调绑定的二维数组变量没有被当前Notebook的全局命名空间持有，就会被Python垃圾回收机制回收。后续尝试触发onClick事件时，回调会拿到被回收后的占位一维数组，直接触发IndexError: too many indices for array: array is 1-dimensional, but 2 were indexed的报错

无需重写代码的落地解决步骤 #

• 调整外部py文件的后端配置逻辑：移除文件开头全局位置的matplotlib.use(xxx)硬编码语句，把后端配置移动到if __name__ == "__main__":的代码块内部，保证该配置仅在脚本被直接作为主程序运行时生效，被其他模块导入/被Notebook加载时不会修改全局后端状态
• 使用带交互参数的%run命令：将原来的%run filename.py替换为%run -i filename.py，-i参数会让脚本在当前Notebook的全局交互命名空间内执行，脚本创建的Figure对象、注册的onClick回调、依赖的数组变量都会被保留在Notebook的全局上下文里，不会执行完就被回收
• 校验onClick回调的依赖逻辑：检查回调函数内引用的二维数组数据是否为全局可访问的对象，不要用临时局部变量存储绘图依赖数据；如果回调内依赖绘图实例取数（比如ax.images[0].get_array()），增加空值判断，避免上下文初始化失败时拿到无效占位数组触发索引越界
• 适配子进程调用场景：如果因为依赖隔离要求必须使用!python调用外部脚本，不要直接在子进程内渲染交互图，改为在Notebook内核内导入脚本中封装好的绘图函数，直接在当前上下文调用。该方式完全不改动原有py文件中给其他模块复用的函数逻辑，同时能完整继承当前Notebook的交互后端配置，不会出现环境隔离导致的交互失效问题

执行顺序提示：调整完成后，先在Notebook单元单独执行%matplotlib notebook确认后端切换成功，再执行脚本加载命令，避免后端被后续脚本配置覆盖。

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