PyQt QWebEngineView加载本地JS文件失败问题求助

核心原因推测 #

JS加载失败但CSS正常的情况，核心大概率是**setHtml的baseUrl参数设置错误**，或是本地资源访问权限限制导致，具体拆解：

1. baseUrl设置逻辑错误
   setHtml的baseUrl是解析HTML中相对路径的基准URL，必须设置为HTML文件所在目录的绝对路径对应的QUrl，而非HTML文件本身的路径。如果误将HTML文件路径作为baseUrl，JS的相对路径会被解析成类似file:///xxx/home_page.html/addons/main_script.js的错误路径，自然加载失败。
   而你的CSS通过LoadCSS函数加载，推测该函数是直接读取CSS内容注入页面（而非通过HTML相对路径引入），因此不受baseUrl错误的影响。
2. 本地资源访问权限限制
   QWebEngineView默认对本地文件的访问有安全限制，若自定义的WebEngine_PythonTerminal类未正确配置权限，可能会阻止JS文件的加载。

具体解决步骤 #

• 修正baseUrl设置
  假设你获取home_page.html绝对路径的代码如下，调整baseUrl为文件所在目录的URL：

  import os
  from PyQt5.QtCore import QUrl
  
  html_file_path = os.path.abspath("HomePage/home_page.html")
  # 正确的baseUrl是HTML文件所在目录的URL
  base_url = QUrl.fromLocalFile(os.path.dirname(html_file_path))
  # 传入setHtml
  your_webview.setHtml(rendered_html, base_url)
  

• 确认本地资源访问权限
  在自定义WebEngine_PythonTerminal类的初始化或配置代码中，添加权限设置：

  from PyQt5.QtWebEngineWidgets import QWebEngineSettings
  
  self.settings().setAttribute(QWebEngineSettings.LocalContentCanAccessFileUrls, True)
  self.settings().setAttribute(QWebEngineSettings.LocalContentCanAccessRemoteUrls, False) # 不需要远程资源可保持False
  

• 排查路径解析问题
  打开开发者工具查看具体错误：

  # 创建QWebEngineView后添加
  your_webview.page().setDevToolsPage(QWebEngineView().page())
  

  启动程序后按F12打开控制台，查看网络请求的错误信息（比如404），确认JS文件的实际请求路径是否正确。

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