如何在PyQt5中嵌入Plotly图表？QWebEngineView导入报错如何解决？

错误根因 #

ImportError: QtWebEngineWidgets must be imported before a QCoreApplication instance is created
这个报错是Qt的内置限制：QWebEngineWidgets模块必须在全局QCoreApplication（包括QApplication）实例创建前完成导入。当前代码触发错误的核心原因是plotly相关库导入顺序早于PyQt5的WebEngine模块，部分版本的plotly依赖的底层图形库会提前初始化Qt应用实例，导致后导入WebEngine模块时触发校验失败。

修复方案 #

核心操作：将所有PyQt5相关导入（尤其是QtWebEngineWidgets）放到plotly及其他第三方库导入之前。

第一段代码修复版 #

# 先导入所有PyQt5相关模块
from PyQt5.QtWebEngineWidgets import QWebEngineView
from PyQt5 import QtCore, QtWidgets
import sys
# 再导入plotly相关模块
import plotly.offline as po
import plotly.graph_objs as go


def show_qt(fig):
    raw_html = '<html><head><meta charset="utf-8" />'
    raw_html += '<script src="https://cdn.plot.ly/plotly-latest.min.js"></script></head>'
    raw_html += '<body>'
    raw_html += po.plot(fig, include_plotlyjs=False, output_type='div')
    raw_html += '</body></html>'

    fig_view = QWebEngineView()
    # setHtml有2MB大小限制，大图场景需改为读取临时文件的setUrl方法
    fig_view.setHtml(raw_html)
    fig_view.show()
    fig_view.raise_()
    return fig_view


if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    fig = go.Figure(data=[{'type': 'scattergl', 'y': [2, 1, 3, 1]}])
    fig_view = show_qt(fig)
    sys.exit(app.exec_())

第二段代码适配说明 #

第二段代码本身已经将PyQt5导入放在plotly之前，如果还是报错请排查两个场景：

• 你在IDE的交互式控制台（如Spyder、Jupyter、PyCharm的Python Console）中运行代码，后台已经预创建了Qt应用实例：请改为直接运行独立Python脚本，或重启IDE内核后再执行
• 环境中同时安装了PyQt5、PySide2/PySide6多个Qt绑定库，产生冲突：请卸载不需要的Qt绑定库，或显式指定导入路径

如果调整后仍然报错，可以在代码最开头第一行就导入WebEngine模块，确保优先级最高：

# 代码第一行优先导入
from PyQt5 import QtWebEngineWidgets

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