PyQt6 QWebEngineView多文件下载失败问题求助

问题根源 #

你的代码中所有QWebEngineView默认共享全局默认QWebEngineProfile，导致downloadRequested信号被多次绑定到同一个槽函数。当多个下载请求触发时，同一个下载对象会被多个槽实例处理，第一个下载被accept()后，后续槽函数再调用setDownloadDirectory/setDownloadFileName就会触发控制台提示的错误，最终只有第一个文件能完成下载。

修正方案 #

为每个QWebEngineView创建独立的QWebEngineProfile，确保每个视图的下载请求独立隔离，不会互相干扰。同时优化信号绑定逻辑，避免重复处理：

from PyQt6.QtWidgets import QWidget, QHBoxLayout
from PyQt6.QtWebEngineWidgets import QWebEngineView, QWebEnginePage, QWebEngineProfile
from PyQt6.QtCore import QUrl, partial

class DownloadFileWindow(QWidget):
    def __init__(self, fileNames: list, urls: list, saveFolder: str):
        super().__init__()
        hbox = QHBoxLayout(self)

        for file_name, url in zip(fileNames, urls):
            # 为每个视图创建独立的Profile
            profile = QWebEngineProfile(f"download_profile_{file_name}", self)
            view = QWebEngineView()
            view.setPage(QWebEnginePage(profile, view))
            
            # 绑定下载信号，正确传递参数
            profile.downloadRequested.connect(
                partial(self.onDownloadRequested, file_name, saveFolder, view)
            )
            view.load(QUrl(url))
            hbox.addWidget(view)

    def onDownloadRequested(self, file_name: str, save_folder: str, view: QWebEngineView, download):
        # 先设置路径和文件名，再接受下载
        download.setDownloadDirectory(save_folder)
        download.setDownloadFileName(file_name)
        download.accept()
        
        # 下载完成后销毁视图，释放资源
        download.finished.connect(lambda: view.deleteLater())

关键优化点 #

• 独立Profile：每个视图使用专属QWebEngineProfile，确保下载信号独立，不会跨视图干扰。
• 资源清理：绑定download.finished信号，下载完成后自动销毁视图，避免内存占用过高。
• 参数传递：通过partial正确传递每个下载对应的文件名、保存路径和视图对象，避免参数绑定错误。

补充说明 #

如果不需要同时显示多个下载窗口，也可以采用串行下载方式（前一个下载完成后再启动下一个），更节省系统资源：

from PyQt6.QtWidgets import QWidget
from PyQt6.QtWebEngineWidgets import QWebEngineView, QWebEnginePage, QWebEngineProfile
from PyQt6.QtCore import QUrl

class SerialDownloader(QWidget):
    def __init__(self, fileNames: list, urls: list, saveFolder: str):
        super().__init__()
        self.file_names = fileNames.copy()
        self.urls = urls.copy()
        self.save_folder = saveFolder
        self.current_index = 0
        
        self.profile = QWebEngineProfile("serial_download_profile", self)
        self.view = QWebEngineView()
        self.view.setPage(QWebEnginePage(self.profile, self.view))
        self.profile.downloadRequested.connect(self.onDownloadRequested)
        
        self.start_next_download()

    def start_next_download(self):
        if self.current_index >= len(self.file_names):
            self.close()
            return
        url = self.urls[self.current_index]
        self.view.load(QUrl(url))

    def onDownloadRequested(self, download):
        file_name = self.file_names[self.current_index]
        download.setDownloadDirectory(self.save_folder)
        download.setDownloadFileName(file_name)
        download.accept()
        download.finished.connect(self.on_download_finished)

    def on_download_finished(self):
        self.current_index += 1
        self.start_next_download()

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