PySide6 QWebEngineView如何设置User-Agent自定义请求头加载移动端网页

现有代码与问题 #

当前使用QWebEngineView加载网页的初始化代码如下：

self.webEngineView = QWebEngineView()
self.initialUrl = 'http://www.bing.com'
self.webEngineView.load(QUrl(self.initialUrl))
self.right_bottom_layout.addWidget(self.webEngineView, 0, 0)

默认配置下组件会使用桌面端UA加载PC版网页，在窗口内显示尺度过大，排版效果差，需要调整配置加载移动端适配版本的页面，参考显示效果：

具体实现方法 #

QWebEngineView默认没有直接暴露修改全局请求头的接口，需要通过自定义QWebEngineUrlRequestInterceptor拦截所有请求修改头信息，同时配置对应浏览参数模拟移动端环境：

1. 先导入所需依赖

from PySide6.QtWebEngineCore import (
    QWebEngineProfile,
    QWebEngineUrlRequestInterceptor,
    QWebEnginePage
)
from PySide6.QtCore import QUrl
from PySide6.QtWebEngineWidgets import QWebEngineView

2. 实现自定义请求拦截器，统一替换请求UA为移动端标识

class MobileReqInterceptor(QWebEngineUrlRequestInterceptor):
    def interceptRequest(self, info):
        # 这里使用iOS Safari的移动端UA，如需模拟安卓端可替换为对应安卓Chrome UA
        mobile_user_agent = "Mozilla/5.0 (iPhone; CPU iPhone OS 17_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.2 Mobile/15E148 Safari/604.1"
        info.setHttpHeader(b"User-Agent", mobile_user_agent.encode("utf-8"))
        # 如需添加其他自定义请求头，按相同格式追加即可，例如：
        # info.setHttpHeader(b"Referer", b"https://your-domain.com")

3. 修改原有QWebEngineView初始化逻辑，绑定拦截器并调整显示参数

self.webEngineView = QWebEngineView()
# 创建独立的浏览器配置文件，避免影响全局默认配置
mobile_profile = QWebEngineProfile("mobile_mode_profile", self.webEngineView)
# 绑定自定义请求拦截器
req_interceptor = MobileReqInterceptor(self.webEngineView)
mobile_profile.setUrlRequestInterceptor(req_interceptor)
# 用自定义配置创建网页实例绑定到view
mobile_page = QWebEnginePage(mobile_profile, self.webEngineView)
self.webEngineView.setPage(mobile_page)
# 按需调整缩放系数，适配窗口尺寸，通常0.7-0.9区间即可匹配移动端页面宽度
self.webEngineView.page().setZoomFactor(0.8)

self.initialUrl = 'http://www.bing.com'
self.webEngineView.load(QUrl(self.initialUrl))
self.right_bottom_layout.addWidget(self.webEngineView, 0, 0)

可选调整项 #

• 若需要模拟安卓端访问，替换UA为安卓端标识即可，参考值：Mozilla/5.0 (Linux; Android 14; Pixel 8 Pro) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36
• 缩放系数可根据实际软件窗口大小动态调整，保证移动端页面内容完整显示无横向滚动条即可。
• 该拦截逻辑对组件加载的所有资源（页面、JS/CSS静态资源、接口请求）均生效，无需单独为单个请求配置头信息。

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