Chrome 76转PDF时Chromedriver偶发TypeError问题求解决方案

这个偶发的错误确实头疼——我之前也帮不少开发者排查过类似的问题，大概率是ChromeDriver和浏览器的通信不稳定、页面加载不及时，或者Driver实例状态异常导致的。下面给你几个针对性的解决办法，按优先级尝试：

1. 严格对齐Chrome与ChromeDriver的版本 #

你现在用的Chrome是76.0.3809.132，但ChromeDriver是76.0.1——这里有个关键细节：ChromeDriver的版本号必须和Chrome的完整主版本前缀完全匹配。比如Chrome 76.0.3809.xxx对应的官方ChromeDriver版本是76.0.3809.126。版本差一点就可能导致偶发的通信丢包，让本该返回的对象变成None。赶紧下载和你Chrome版本完全一致的ChromeDriver替换当前版本，这是最容易见效的步骤。

2. 等待页面完全加载后再执行PDF转换 #

很多时候这个错误是因为代码着急执行PDF生成，页面还没加载完成，导致Driver返回的对象为None。建议添加显式等待，确保页面真正就绪：

# 示例Python代码（基于Selenium）
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# 打开页面后，等待文档加载完成
WebDriverWait(driver, 10).until(
    lambda d: d.execute_script('return document.readyState') == 'complete'
)
# 也可以等待页面内的关键元素加载完成，比如body标签
# WebDriverWait(driver, 10).until(EC.presence_of_element_located((By.TAG_NAME, "body")))

# 再执行PDF转换
pdf_result = driver.execute_cdp_cmd("Page.printToPDF", {"printBackground": True})

3. 优化Driver实例的稳定性 #

偶发的NoneType错误也可能是Driver实例运行中出现了异常状态，比如内存泄漏、残留进程干扰。可以试试这些优化：

• 每次转换完成后，用driver.quit()彻底关闭Driver（而不是driver.close()），避免残留进程影响后续运行；
• 如果是批量转换任务，每次转换都创建新的Driver实例，不要复用同一个；
• 给Driver添加启动参数，提升稳定性：

from selenium import webdriver

options = webdriver.ChromeOptions()
options.add_argument('--no-sandbox')  # 规避Linux环境下的权限问题
options.add_argument('--disable-dev-shm-usage')  # 解决临时内存不足的问题
options.add_argument('--disable-gpu')  # 无头模式下建议添加
options.add_argument('--headless')  # 无头运行时启用

driver = webdriver.Chrome(options=options, executable_path='你的chromedriver路径')

4. 添加异常捕获与重试逻辑 #

既然问题是偶发的，可以在代码中捕获这个特定错误，进行重试：

import time

def html_to_pdf(driver, target_url):
    max_retries = 3
    for attempt in range(max_retries):
        try:
            driver.get(target_url)
            # 等待页面加载
            WebDriverWait(driver, 10).until(lambda d: d.execute_script('return document.readyState') == 'complete')
            pdf_data = driver.execute_cdp_cmd("Page.printToPDF", {"printBackground": True})
            return pdf_data
        except TypeError as e:
            if "'NoneType' object is not subscriptable" in str(e) and attempt < max_retries - 1:
                time.sleep(2)  # 等待2秒后重试
                continue
            else:
                raise  # 超过重试次数后抛出原错误

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