Playwright中Chrome启动参数未生效问题求助

问题原因 #

--start-maximized参数失效主要有两个核心原因：一是无头模式（headless=True）下Chrome会忽略窗口最大化类启动参数，默认使用固定视口尺寸；二是如果你的user_data_dir保存过旧的窗口配置，Chrome会优先加载本地配置，覆盖启动参数。

具体解决方案 #

方案1：无头模式下强制控制视口 #

在launch_persistent_context中添加viewport=None，禁用Playwright默认视口限制，让浏览器跟随系统设置或启动参数：

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.launch_persistent_context(
            user_data_dir=USER_DATA_DIR,
            headless=True,
            executable_path=r"C:\Program Files\Google\Chrome\Application\chrome.exe",
            viewport=None,  # 关键配置：取消默认视口限制
            args=[
                "--start-maximized",
                "--disable-notifications",
                "--disable-infobars",
                "--no-default-browser-check",
                "--disable-blink-features=AutomationControlled",
                "--user-agent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36",
                "--no-sandbox",
                "--disable-setuid-sandbox"
            ]
        )

如果需要固定分辨率，可替换viewport=None为具体尺寸：

viewport={"width": 1920, "height": 1080}

方案2：关闭无头模式（有界面启动） #

如果不需要无头运行，将headless=True改为headless=False，此时--start-maximized会正常触发Chrome最大化启动。

方案3：强制覆盖本地窗口配置 #

若user_data_dir中的旧配置干扰了启动参数，可在args中添加--window-size强制指定窗口大小，直接覆盖本地配置：

args=[
    # 保留原有参数
    "--window-size=1920,1080"  # 替换为你的目标分辨率
]

验证生效状态 #

启动后可通过代码获取视口尺寸确认配置是否生效：

# 获取当前页面（无页面则新建）
page = browser.pages[0] if browser.pages else await browser.new_page()
# 打印视口尺寸
print(await page.viewport_size())

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