如何在RequestInterceptor中正确设置QWebEngine HTTP请求头？

嘿，我之前也踩过这个坑！QWebEngineUrlRequestInterceptor里的setHttpHeader确实有不少容易混淆的细节，尤其是Python环境下的类型处理，咱们一步步捋清楚：

核心要点先划重点 #

1. 不需要手动用QByteArray包裹参数！这大概率是你报错的根源——PyQt5在Python环境下已经做了自动类型转换，直接传Python的字符串（str）或字节串（bytes）就行。
2. HTTP请求头的键和值，在Python里直接用UTF-8字符串传递即可，不需要额外手动编码（Python3默认字符串就是Unicode，PyQt会自动处理成符合HTTP规范的字节流）。

完整可运行的示例代码 #

from PyQt5.QtWebEngineCore import QWebEngineUrlRequestInterceptor, QWebEngineUrlRequestInfo
from PyQt5.QtWebEngineWidgets import QWebEngineView
from PyQt5.QtWidgets import QApplication
import sys

class CustomRequestInterceptor(QWebEngineUrlRequestInterceptor):
    def interceptRequest(self, info: QWebEngineUrlRequestInfo):
        # 方式1：直接传Python字符串（推荐，更直观）
        info.setHttpHeader("User-Agent", "My Custom PyQt5 Browser/1.0")
        # 方式2：传字节串（带b前缀），效果和字符串一致
        info.setHttpHeader(b"X-Requested-With", b"PyQt5 QWebEngine")
        
        # 包含非ASCII字符的请求头也直接传字符串就行
        info.setHttpHeader("X-Custom-Header", "这是自定义中文请求头")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    browser = QWebEngineView()
    
    # 绑定拦截器到浏览器的Profile
    interceptor = CustomRequestInterceptor()
    browser.page().profile().setRequestInterceptor(interceptor)
    
    browser.load("https://example.com")
    browser.show()
    sys.exit(app.exec_())

你之前遇到的问题解析 #

• QByteArray报错：在Python环境下，PyQt5已经对原生类型做了适配，强行手动创建QByteArray传递给setHttpHeader，反而会因为类型不匹配触发错误。直接用Python的str/bytes就好。
• 编码问题：Python3的str是Unicode编码，PyQt会自动将其转换为UTF-8字节流发送给服务器，不需要你手动调用str.encode()。如果强行编码成bytes再传递，虽然也能生效，但属于多余操作。

验证是否生效的小技巧 #

可以用Charles、Fiddler这类抓包工具，查看请求的Header部分，确认你设置的自定义头是否已经正确出现在请求里。

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