为什么PySide6的QWebEngineView加载本地HTML文件时提示无法访问？

根因 #

手动拼接file:///前缀生成文件URL的方式不规范，未自动处理路径中的特殊字符转义、跨平台路径适配逻辑，即使本地绝对路径打印正常，生成的QUrl也不符合标准，导致QWebEngineView无法识别资源。

修复方法 #

替换手动拼接URL的逻辑，使用Qt内置的QUrl.fromLocalFile()接口生成合规的本地文件URL即可。

修改后的完整代码：

import sys

from PySide6.QtWidgets import (QApplication, QWidget, QVBoxLayout)
from PySide6 import QtCore
from PySide6.QtWebEngineWidgets import QWebEngineView


class webView(QWidget):
    def __init__(self):
        super(webView, self).__init__()

        self.layout = QVBoxLayout(self)

        self.webV = QWebEngineView()
        self.fileDir = QtCore.QFileInfo("./docs.html").absoluteFilePath()
        print(self.fileDir)
        # 替换原有手动拼接逻辑
        self.webV.load(QtCore.QUrl.fromLocalFile(self.fileDir))

        self.layout.addWidget(self.webV)


if __name__ == "__main__":
    app = QApplication([])

    web = webView()
    web.show()

    sys.exit(app.exec())

如果修改后仍有问题，可以增加调试逻辑确认URL有效性：

target_url = QtCore.QUrl.fromLocalFile(self.fileDir)
print("URL是否有效：", target_url.isValid())
print("生成的URL：", target_url.toString())
self.webV.load(target_url)

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