如何在PyQt6/PySide6的QWebEngineView中启用WebGL？

问题分析 #

出现D3D11相关错误且WebGL无法启用，核心原因多为GPU硬件加速兼容性问题、Qt组件版本不匹配，或是WebEngine配置未完全生效。以下是针对性解决步骤：

1. 强制绕开GPU硬件加速 #

D3D11错误通常和显卡驱动或硬件加速兼容性有关，直接禁用GPU加速改用软件渲染，这行代码必须放在创建QApplication实例之前：

import os
os.environ["QTWEBENGINE_CHROMIUM_FLAGS"] = "--disable-gpu"

若禁用GPU后仍有问题，可补充软件光栅化参数：

os.environ["QTWEBENGINE_CHROMIUM_FLAGS"] = "--disable-gpu --disable-software-rasterizer"

2. 确认WebGL配置正确生效 #

需同时开启全局和视图级的WebGL设置，避免只配置其中一项：

# PyQt6示例
from PyQt6.QtWebEngineWidgets import QWebEngineView
from PyQt6.QtWebEngineCore import QWebEngineSettings

# 全局生效的设置
QWebEngineSettings.globalSettings().setAttribute(
    QWebEngineSettings.WebAttribute.WebGLEnabled, True
)

# 单个视图的补充设置
web_view = QWebEngineView()
web_view.settings().setAttribute(
    QWebEngineSettings.WebAttribute.WebGLEnabled, True
)

3. 修复Qt组件版本不匹配 #

你的PyQt6（6.6.1）和PyQt6-WebEngine（6.6.0）版本不一致，会导致底层兼容性问题，立即升级WebEngine到对应版本：

pip install --upgrade PyQt6-WebEngine==6.6.1

4. 更新显卡驱动 #

D3D11错误本质是显卡驱动对Chromium内核的支持不足，前往显卡厂商官网（NVIDIA/AMD/Intel）下载并安装最新驱动，重启电脑后再测试。

5. 忽略GPU黑名单 #

若访问chrome://gpu显示WebGL因安全黑名单被禁用，添加参数强制忽略：

os.environ["QTWEBENGINE_CHROMIUM_FLAGS"] = "--ignore-gpu-blocklist"

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