plotly调用fig.write_image()无响应无法导出png文件是什么原因?
Plotly 执行 fig.write_image() 导出PNG无限卡死解决方案
- kaleido版本兼容性问题:最新版kaleido存在已知的跨平台兼容bug,可降级到0.2.1稳定版验证,执行命令:
pip install kaleido==0.2.1 - 路径异常问题:保存路径包含中文、特殊字符,或是需要管理员权限的系统目录、网络挂载路径时,会导致kaleido写入卡住。测试时优先使用无特殊字符的用户目录绝对路径,例如Windows下用
fig.write_image("C:/Users/当前用户名/Desktop/test.png"),Linux/macOS下用fig.write_image("/home/当前用户名/test.png")。 - 参数配置优化:调用写入方法时强制指定渲染引擎、添加超时参数,避免无限等待同时可以触发报错方便定位问题,示例代码:
fig.write_image("test.png", engine="kaleido", timeout=30) - 运行环境冲突问题:在多线程、异步函数、多实例Jupyter环境下运行时,kaleido的子进程调用可能出现死锁。可将write_image逻辑移到主线程单独执行,执行前先手动清理后台残留的kaleido进程后再运行代码。
- 版本匹配问题:如果kaleido降级后仍无效,可将plotly升级到和kaleido 0.2.1兼容性最好的5.15.0版本,执行命令:
pip install -U plotly==5.15.0
内容的提问来源于stack exchange,提问作者황준석
相关产品推荐
相关产品推荐

